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APPENDIX A 


RSX-11M SUPPORTED DEVICES 


A.1l RSX-11M DEVICE SUPPORT 


RSX-11M is a disk based real-time operating system that runs on any 
UNIBUS PDP-11 processor. During system generation, the user can 
configure RSX-l1M for systems ranging in size from 16K- to 
1920K-words. 


The user can generate RSX-11M as either a mapped or unmapped = system. 
A mapped system must include the KT11 Memory Management Unit. Without 
the KT11 Memory Management Unit, RSX-11M supports between 16K- and 
28K-words of memory. With the KT11, RSX-11M supports between 24K- and 
124K-words of memory on processors other than the PDP-11/70. RSX-11M 
provides the same primary services for both mapped and unmapped 
systems; however, some supplied optional features and separately 
orderable options reguire hardware configurations larger than the 
minimum supported system. 


For complete and detailed information about minimum hardware required 
for the different kinds of RSX-11M distribution kits, various options, 
and combinations of peripherals, see the DIGITAL Software Product 
Description for RSX11-M, Version 3.1, Real Time Operating System and 


the RSX-l1M System Generation Manual. The RSX-11M Operator's 


Procedures Manual contains a table of RSX-11M peripheral, pseudo, and 
null devices along with their respective identifiers (device-unit 
names recognized by RSX-11M). 


RSX-11M supports the following: 


A.1.1 Processors And Options 
e Any PDP-11l processor except the LSI-11 and PDP-11/03 
- A minimum of 16K-words of memory (unmapped system) 
- Between 24K and 124K-words of memory on a system other than 
the PDP-11/70 (mapped system with the KT11 Memory Management 
Unit); and between 64K and 1920K-words on the PDP-11/70. 


- KT1l1 Memory Management Unit (requires a minimum of 24K-words 
of memory) 


- KE11-A,B Extended Arithmetic Element (on systems without a 
memory management unit) 


- KELI-E Extended Instruction Set 


~ KELI-F Floating Instruction Set 


A.1.2 
e 


A.1.3 


A.1.4 
One or 


RSX-11M SUPPORTED DEVICES 


- FP11 Floating Point Processor 


- KW11-Y Watch-dog Timer Clock 


Card Readers 
CRl1 card reader 


CMl1 card reader 


Communications 

DL11-E single line interface 

DP1l synchronous line interface 
DU11 synchronous line interface 
DUP11 synchronous line interface 
DQ11 DMA synchronous line interface 
DA11-B DMA UNIBUS link 


DMCll interprocessor link 


Data Acquisition 
more of the following subsystems: 


LPS1l1 Laboratory Peripheral System (requires LPS11-S, 
LPSAD-12, and LPSKW) 


AR11 Analog Real-time System 
LPA11-K Laboratory Peripheral Accelerator 


Laboratory I/O Subsystem configured using the following 
options: 


1. ADK1I1-KT 12-bit A/D converter with 16-channel multiplexer 
and dual clock; one per subsystem) 


2. ADI11-K 12-bit A/D converter with 16-channel multiplexer; 
16 per subsystem (15 if ADKI1-KT is part of same 
subsystem) 


KW1l1-K Dual real-time clock with Schmitt triggers; 1 per 
subsystem (clock already included in ADK11-KT, not KW11-K 
required if one is present) 


4. AM11-K 48-channel A/D multiplexer with gain ranging; one 
per AD11-K or ADK11-KT 


5. DRI1-K 16-bit digital I/O option; 16 per subsystem 


6. AAII-K 4-channel 12-bit D/A converter with scope control, 
16 per subsystem 


RSX-11M SUPPORTED DEVICES 


A.1.5 Disk Devices 


RX1l1 floppy disk system 

RFll fixed-head disk system 

RK11 disk cartridge controller with RKO5J or RKOSF disk drives 
RK611 disk cartridge controller with RKO6 or RKO7 disk drives 
RPRO2 disk pack drives (with appropriate controller) 

RPO3 disk pack drives (with appropriate controller) 


RPO4, RPOS, or RPO6 disk pack drives (with appropriate 
controller) 


RSO3 or RSO4 fixed-head disks (with appropriate controller) 
RMO3 drives (with appropriate controller) 
RL11 disk cartridge controller with RLO1l disk drives 


RMO2 drives (with appropriate controller) 


Laboratory/industrial Control 


ADO1-D A/D converter 

AFC11 A/D converter 

DRS/DSS11 industrial control system modules 
UDC11 Universal Digital Controller 
IDA1L1-AA Contact sense module 
IDA11-AB Contact sense module 
IDA11-BA Contact interrupt module 
IDA11-BB Contact interrupt module 
IDA11-CA I/O converter 

IDA1I1-DA Solid state AC/DC driver 
IDA1L1-EA Flip-flop DC driver 
IDAlI1-FA Single shot driver 
IDAL1-GA Latching output relay 
IDALI1-HA Flip-flop output relay 
IDAL1-JA Single shot output relay 
IAAL1-AA Multi-range A/D converter 
IAAL1-BA D/A converter 


ITAA11-BB D/A converter 
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@ IAA11-BC D/A converter 

@e IAA11-BD D/A converter 

@ ICS11/ICR11 Industrial Control subsystem 
e IDC-IA Isolated DC sense 

e IDC-IB Isolated DC interrupt 

e IDC-IC I/O counter 

@e IDC-ID Non-isolated DC sense 

e@ IDC-IE Non-isolated DC interrupt 
e IAC-IA Isolated AC sense 

e IAC-IB Isolated AC interrupt 

® IDC-OA DC flip-flop driver 

@e IDC-OB DC single shot driver 

e IAC-OA AC flip-flop driver 

e IAC-OB AC single shot driver 

@ IRL-OA Latching output relay 

@ IRL-OB Flip-flop output relay 

@e IDA-OB 4-channel D/A converter 

@e IAD-IA 8-channel A/D converter 


@e IMX-IA 16-channel multiplexer for IAD-IA 


A.1.7 Printers 
e LA35 line printer 
@ LA180 line printer 
@ LSll line printer 
e LPll line printer 


@e LVll line printer (no plotter support) 


A.1.8 Tape Devices, Magnetic 
e TAl11 Dual drive cassette system 
e TCll DECtape controller and dual transport 
e TS03 magnetic tape transport (with appropriate controller) 


e TU10 magnetic tape transport (with appropriate controller) 
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@ TE1O magnetic tape transport (with appropriate controller) 
e TU16 magnetic tape transport (with appropriate controller) 
@ TE16 magnetic tape transport (with appropriate controller) 


e TU45 magnetic tape transport (with appropriate controller) 


A.1.9 Tape Devices, Paper 
e PCll paper tape reader/punch 


@ PRI1 paper tape reader 


A.1.10 Terminals 
e LA30 terminal 
@e LA36 terminal 
e LA180S terminal on the following line devices only: 


- DH11 serial line terminal multiplexer (optional with DM11-BB 
modem control) “= 


- DZ11 serial line terminal multiplexer 
- DJ1ll serial line terminal multiplexer 
~ DL11-A,B,C,D,W single line terminal interface 
e LT33 terminal 
e LT35 terminal 
e vT05 terminal 
e VvT50 terminal 
e VT52 terminal 


e vT55 terminal 
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CODING STANDARDS AND CONVENTIONS 


B.1 CODING STANDARD INTRODUCTION 


This Appendix contains DIGITAL's PDP-11 Program Coding Standard. We 
Suggest that you use this standard for you own installation when 
writing code, such as I/O drivers, for use with the PDP=-1l. 


B.1l.1 Line Format 


All source lines consist of from one to a maximum of eighty characters 
(not including the audit trail added by the SLIPR (SLP in RSX-11M) 
editor). This program is described in the RSX-11M utilities manual. 


Assembly language code lines have the following format: 


l. Label field - if present, the label starts at tab stop 0 
(column 1). 


2. Operation field - the operation fiedl starts at tab stop d.: 
(column 9). 


3. Operand field - the operand field starts at tab stop 2 
(column 17). 


4, Comments field - the comments field starts at tab stop 4 
(column 33) and may continue to column 80. 


Include comment lines in the code body by delimiting them with a line 
that contains only a semicolon. The comment lines contain a leading 
semicolon with the comment itself starting in column 3. 


If the operand field extends beyond tab stop 4 (column 33), leave a 
Space and start the comment. Comments that apply to an instruction 
but reguire continuation should always line up with the character that 
Started the comment. 


B.1.2 Comments 


Comment all coding to convey the global role of an instruction, rather 
than a simple literal translation of the instruction into English. In 
general, this consists of a comment for each line of code. If a 
particularly elegant instruction sequence is used, precede that 
section of code with a paragraph of comments. 


Delimit preface text, which describes formats, algorithms, 
program-local variables, etc., by the character sequence ;+ at the 
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start of the text and ;- at the end. These delimiters ease the 
extraction of the text by a program which could be designed for the 
purpose. The comments themselves start in column 3. 


For example: 


+- 


THE INVERT ROUTINE ACCEPTS 

A LIST OF RANDOM NUMBERS AND 
APPLIES THE KOLMOGOROV ALGORITHM 
TO THEM 


me =e tO NS TO NO 


B.1.3 Naming Standards 


B.1.3.1 Register Standards - 


B.1.3.1.1 General Purpose Registers - The following names are _ the 
only ones permitted for register names and may not be used for other 
purposes: 


RO=0 ;REG 0 

R1=1 s;REG 1 

R2=2 ;REG 2 

R3=3 ;REG 3 

R4=4 7;REG 4 

R5=5 ;REG 5 

SP=6 ;STACK POINTER (REG 6) 
PC=7 ;PROGRAM COUNTER (REG 7) 


B.1.3.1.2 Hardware Registers - Name hardware registers identically to 
the hardware definition. For example, PS and SWR. 


B.1.3.1.3 Device Registers - Device registers are symbolically and 
identically named to the hardware notation. For example, the control 
status register for the RK disk is  RKCS. You may use only this 
symbolic name to refer to this register. 


B.1.3.2 Processor Priority - Use the following bits to test or alter 
processor priority: 


PRO, PRI, PR2, isecew PR? 


The system equates thes bits to their corresponding bit pattern. 


B.1.3.3 Other Symbols - Make frequently-used bit patterns, such as CR 
and LF, conventional symbols on an as-needed basis. 
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B.1.3.4 Using the Standard Symbols - Register standards are defined 
within the assembler. All other standard symbols appear in a file and 
are linked prior to program execution. 


B.1.4 Symbols 


B.1.4.1 Global Symbols - You can easily recognize global symbols by 
their format. The following standards apply and completely define 
symbol standards for PDP-1l Medium/Large software products. 


Figure B-l1 describes the difference among global and local symbols. 


Pa ae 


| symbol | Length | 
Non global AN or AN or AN or AN or AN or 
symbol null null null null null 
Global $ or .| AN or AN or AN or AN or AN or 
symbol null null null null null 
Global L $ or. AN or AN or AN or >=3 
offset null null null 
Global bit L AN S6r 5 AN AN or AN or >=4 
pattern null null 
Local $ >=2 
symbol 


where: 

L is a letter 

AN is an alphanumeric character 

null is no character 

$ is a dollar sign (reserved for DEC-supplied software) 

‘ is a period (reserved for DEC-supplied software) 

N is a number in the range of 0 through 65535 

* means that branch targets in the form of x$, where x is a 


number, are also called labels. 


Figure B-l Difference Among Global and Local Symbols 
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B.1.4.2 Symbol Examples - Non-global Symbols 
AlB 
ZXCJ1 
INSRT 
Global Address Symbols 
$JIM 
-VECTR 
$SEC 
Global Absolute Offset Symbols 
ASJIM 
ASXT 
A.ENT 
Global Bit Pattern Symbols 
A1$20 
B3.6 
JIM 
Local Symbols 
37$ 
271$ 
6$ 


B.1.4.3 Program-Local Symbols - Self-relative address arithmetic 
(.+n) is absolutely forbidden in branch instructions. It must not be 
used in other contexts if at all possible. 


Target labels (symbols) for branches that exist only for positional 
reference use local symbols of the form: 


<num>s: 


Restrict use of global symbols to cases where reference to the symbol 
occurs external to the code. The assembler formats local symbols to 
proceed sequentially down the page and from page to page. 


B.1.4.4 Macro Names - The last two characters in a macro name have 
special significance. The next to last character is a $ and the last 
character specifies the mode of the macro. (The last character may 
also be a null character.) 
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For example, three macro forms exist: in-line, stack, and p~section. 
The in-line form has no suffix (the $ is last). The stack has an S as 
the last character. The p-section has a C as the last character. 
Thus, the QUEUE I/O macro can be written in any one of the three 
following ways: 


QIO$ 
QIOss 
QIOSC 


The letters S and C are not reserved but the form of the macro is 
standard. 


B.1.5 Program Modules 


B.1.5.1 General Comments on Programs - In DEC software, a program 
provides a single distinct function. No limits exist on size, but the 
Single function limitation makes large modules a rarity. Because any 
software may exploit the memory capacity of the 11/40, 11/45, or 
11/70, programs should maintain a dense reference locus (branching 
should occur over short address distances). 


All code is read only. Code and data areas are distinct and each 
contains explanatory text. Read-only data should be segregated from 
read-write data. 


B.1.5.2 Module Preface - Each program module in the system exists as 
a separate file. The filename reflects the name of the module and the 
extension is of the form 'NNN'. NNN signifies the edit number or the 
version number. The version number is changed only when a new base 
level is created. Furthermore, if no corrections are made to a file 
from one base level to the next, the version number is not changed. 
The availability if File Control Services and File Control Primitives 
greatly simplify version number maintenance. Program modules adhere 
to a strict format. Reading and understanding the code is easier 
because of this format. The following sections are in each module: 


For the code section: 
1. A .TITLE statement that specifies the name of the module. If 
a module contains more than one routine, you may use 
subtitles. 


2. A .IDENT statement that specifies the version number. The 
PDP-11 version number standard appears in section B.10. 


3. A .PSECT statement that defines the program section in which 
the module resides. 


4. A copyright statement and the disclaimer. 
5. The version number of the file. 


The PDP-1l version number standard is described in section 
B.10. 


ll. 


LZ 
13. 


14. 


Loe 


16. 


Belsds.3 
1. 
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The name of the principal author and the date on which the 
module was first created. 


The name of each modifying author and the date of the 
modification. Names and modification dates appear one per 
line and in cronological order. 


A brief statement of the function of the module. 
Note: Items 1-8 should appear on the same page. 


A list of the definitions of all equated local symbols’ used 
in the module. These definitions appear one per line and in 
alphabetical order. 


All local macro definitions, preferably in alphabetical order 
by name. 


All local data. The data should indicate: 

a. Description of each element (type, size, etc.) 

b. Organization (functional, alpha, adjacent, etc.) 

c. Adjacency requirements. 

A more detailed definition of the function of the module. 


A list of the inputs expected by the module. This includes 
the calling sequence if non-standard, condition code 
settings, and global data settings. 


A list of the outputs produced as a result of entering this 
module. These include delivered results, condition code’ 
settings, but not side effects. (All these outputs are 
visible to the caller.) 


A list of all effects (including side effects) produced as a 
result of entering this module. Effects include alterations 
in the state of the system not explicitly expected in the 
calling sequence, or those not visible to the caller. 


The module code. 


Formatting the Module Preface - Rules: 


The first eight items appear on the same page and should not 
have explicit headings. Item 3 may be omitted if the blank 
P—-section is being used. 


Headings start at the left margin. The left margin consists 
of a semi-colon followed by a space. Therefore, the heading 
Starts in column 3. Indent descriptive text one tab 
position. 


Items 7-14 have headings that start at the left margin and 
are preceded and followed by lines that contain only a 
leading semi-colon. Omit items that do not apply. 
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An example of a module preface follows: 


FILE-EXAMPL.SO1 


=e “se “@ =e “8 Se “5S “Ss SO We BSF WE SS “SH “SH Te =~SH VE WE “SH Ne UH WH WS WH WS BS NSH “SH TWH TWH WS WH WE 


~e te TO 


=e “Oe tO 


=e “we “eo BO “2 Ss SE “SF NB @SB TWH “WS WS “WS WE 


» TITLE EXAMPLE 
- IDENT /01/ 
»PSECT KERNEL 


COPYRIGHT (C) 1978 

DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS. 

THIS SOFTWARE IS FURNISHED UNDER A LICENSE FOR USE ONLY ON A 
SINGLE COMPUTER SYSTEM AND MAY BE COPIED ONLY WITH THE 
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE, OR 
ANY OTHER COPIES THEREOF, MAY NOT BE PROVIDED OR OTHERWISE 
MADE AVAILABLE TO ANY OTHER PERSON EXCEPT FOR USE ON SUCH 
SYSTEM AND TO ONE WHO AGREES TO THESE LICENSE TERMS. TITLE 
TO AND OWNERSHIP OF THE SOFTWARE SHALL AT ALL TIMES REMAIN 

IN DEC. 

THE INFORMATION IN THIS DOCUMENT IS SUBJECT TO CHANGE WITHOUT 
NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL 
EQUIPMENT CORPORATION. 


DEC ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF 
ITS SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DEC. 


VERSION O01 

JOHN HANCOCK 1-JAN-75 
MODIFIED BY: 

QUINCY ADAMS 21-JAN-76 
JAMES MONROE 12-JUN-76 
Brief statement of the module's function. 
EQUATED SYMBOLS 

List equated symbols. 
LOCAL MACROS 

Local macros 

LOCAL DATA 

Local data 

Module function details 
INPUTS: 

Description of inputs 
OUTPUTS: 

Description of outputs 
EFFECTS: 

Descriptions of effects 


Begin module code 
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B.1.5.4 Modularity - No other characteristic has more impact on the 
ultimate engineering success of a system than does modularity. 
Modularity for PDP-11 Software Engineering's products consists of the 
application of the single-function philosophy described in section 
B.5.1 and the adherence to a set of calling and return conventions. 


B.1.5.5 Inter-Module Calling Conventions - The following calling 
conventions must be observed: 


Transfer of Control 


Macros exist for call and return. The actual transfer is by a 
JSR PC instruction. For register save routines, a JSR Rn,SAVE 
instruction is permitted. 


The CALL macro is: 
CALL subroutine-name 
The RETURN macro is: 
RETURN 
Register Conventions 


Upon entry, a subroutine minimally saves all registers it intends 
to alter except result registers. Upon exit it restores these 
registers. (State preservation is assumed across calls.) 


Argument Passing 


Any registers may be used to pass arguments, but their use should 
follow a coherent pattern. For example, if passing three 
arguments, pass them in RO, Rl, and R2 rather than RO, R2, and 
R5. Saving and restoring occurs in one place. 


B.1.5.6 Exiting - All subroutine exits occur through a single RETURN 
macro. 


B.1.5.7 Intra-Module Calling Conventions - These calling conventions 
are designer optional, but consistency favors a calling sequence 
identical to that of the inter-module seguence. 


B.1.5.8 Success or Failure Indication - The C-bit indicates success 
or failure where success equals 0 and failure equals 1. You can use 
the argument registers to return values or additional success or 
failure data. 


B.1.5.9 Module Checking Routines - Modules must verify the validity 
of arguments passed to them. The design of a module's calling 
sequence should aim at minimizing the validity checks by minimizing 
invalid combinations. You may add test code to perform additional 
checks during checkout. All code should aim at discovering an error 
as close (in terms of instruction executions) to its occurence as 
possible. 
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B.1.6 Formatting Standards 


B.1.6.1 Program Flow - Programs should be organized on the listing 
such that they flow down the page, even at the cost of an extra branch 
or jump. For example: 


PROCESS 


COMMON 


shall appear on the listing as: 


TST 
BNE BBB 
AAA: eee aoeese 
BR CMN 
BBB: eoene eevee 
CMN 3: ees oe eeoeee 


Rather than: 


TST 

BNE BBB 
AAA: ew-ees esegse 
CMN: eoeee ees8e 
BBB: aeee8? eeeee 

BR CMN 
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B.1.6.2 Common Exits - A common exit appears as the last code 
sequence on the listing, illustrated by the following flow chart: 


EXIT 


should appear on the listing as: 


PR1 3 eeee# eeve 
BR EXIT 

PR2: eeese eoe#ee? 
BR EXIT 

PR3: eoees @eeaees 
BR EXIT 

PR4: esee eeee 

EXIT: se . ee 


and not as: 


PRI : eeees aeees 

EXIT: ees#ss? Ld ee 

PR2 3 s @ e e ee 
BR EXIT 

PR3 . ees e ee 
BR EXIT 

PR4 : oeeoe ° e 
BR EXIT 
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B.1.6.3 Code with Interrupts Inhibited - Code that executes 
instructions with interruptions inhibited, should be flagged by a 
comment delimiter of three semicolons. For example: 


. -ERTZ: ;ENABLE BY RETURNING | 
;BY SYSTEM SUBROUTINES 
BIS PR7,PS ?33 INHIBIT INTERRUPTS 
BIT PR7 ,+2 (SP) 477 
BEQ 10$ 777 #0 
RTT tae M 
773 M 
10S: ee ee ee ea E 
wise ere i733 N 
eeee eoevs8s9 793 T 
eev#2#He¢ eess 777 S 


B.1.7 Program Source Files 


Creation of and maintenance of source code is done in base levels. A 
base level is defined as a point at which changing the program source 
files is no longer allowed. From this "frozen" point to the next base 
level, corrections are not made to the base level itself; rather, a 
file of corrections is accumulated for each file in the base level. 
Whenever a updated source file is desired, the correction file is 
applied to the base file. 


The accumulation of corrections proceeds until a logical breaking 
point has occurred (for example, a milestone or significant 
implementation point is reached). At this time, all accumulated 
corrections are applied to the previous base level to create a new 
base level. Correction files are then started for the new base level. 


B.1.8 Forbidden Instruction Usage 
The following instruction usage is not allowed: 


1. The use of intructions or index words as literals of the 
previous instruction. For example, the sequence: 


MOV @PC,REGISTER 
BIC SRC,DST 


uses the bit clear instruction as a literal. This may seem 
to be a very good way to save a word but this compounds the 
problem of program maintenance. To make matters worse, this 
sequence does not execute correctly if I/D space is enabled 
on the PDP-11/45. In this case, @PC is a D bank reference. 


2. The use of the MOV instruction instead of a JMP instruction 
to transfer program control to another location. For 
example: 


MOV ALPHA,PC 


transfers control to location ALPHA. Besides taking longer 
to execute (2.3 microseconds for the MOV vs. 1.2 for the 
JMP) the use of MOV instead of JMP makes it nearly impossible 
to pick up someone else's program and tell where transfers of 
control take place. A jump trace of a program's execution is 
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impossible in this case (a move trace is unheard of). Asa 
more general issue, other operations such as ADD and SUB from 
the PC should be discouraged. Possibly one or two words can 
be saved by using these operations, but occurences where 
these operations can be used are rare. 


3. The seemingly clever use of all single word instructions 
where one double-word instruction could be used, would 
execute faster, and would not consume additional memory. 
Consider the following instruction sequence: 


CMP -(R1),(-R1) 
CMP -(R1) ,~(R1) 


The intent of this instruction sequence is to subtract 8 from 
register Rl (not to set condition codes). This can be 
accomplished in approximately 1/3 the time by using a SUB 
instruction (9.4 vs. 3.8 microseconds) at no additional cost 
in memory space. Also, if Rl is odd this instruction does 
not give the correct result. The SUB instruction is always 
faster and always executes correctly. 


B.1.9 Recommended Coding Practice 


B.1.9.1 Conditional Branches - When using the PDP-1l1 conditional 
branch instructions, the correct choice must be made between the 
signed and the unsigned branches. 


Signed Unsigned 
BGE BHIS (BCC) 
BLT BLO 

BGT BHI 

BLE BLOS (BCS) 


A common pitfall is to use a signed branch (for example, BGT) when 
comparing two memory addresses. This compare works until the two 
addresses have opposite signs; that is, one of them goes across’ the 
16K (100000(8)) boundary. This type of coding error usually occurs 
when a program is re-linked at different addresses or the program's 
size is changed. 


B.1.10 PDP-1l Version Number Standard 


The PDP-l1l Version Number Standard applies to all modules, parameter 
files, complete programs, and libraries that are written as part of 
the PDP-1l Software Development effort. It provides unigue 
identification of all released, pre-released, and in-house software. 


It is limited because, as currently specified, only six characters of 


identification are used. Future implementations of the Macro 
Assembler, Task Builder, and Librarian should provide for at least 
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nine characters, and possibly twelve. This standard will change as 
the need arises. The version identifier takes the following form: 


Version Identifier = <form> <version> <edit> <patch> 


<form> Identifies a particular form of a module or 
program, where applicable, as in the case of 
LINK-ll. One alphabetic character, if used, and 
null (for example, a binary 0) if not used. 


<version> Identifies the release or generation of a program. 
The version number is two decimal digits that 
start at 00 and is incremented at the discretion 
of the project to reflect a major change. 


<edit> Identifies the level to which a particular release 
Or generation of a program or module has been 
edited. An edit is an alteration to the source 
form. The edit number consists of two decimal 
digits that begin at Ol. The number is 
incremented with each edit and remains null if no 
edit occurs. 


<patch> Identifies the level to which a particular release 
Or generation of a program or module has been 
patched. A patch is an alteration to a binary 
form. The patch identification consists of one 
alphabetic character that starts at B. The 
character is changed toward Z each time a set of 
patches is released and remains null if no patches 
are made. 


These fields are interrelated. When version is changed, patch and 


edit must be reset to nulls. When edit is incremented, patch is 
re-set to null because various bugs have been fixed. 


B.1.10.1 Displaying the Version Identifier - The visible output of 
the version identifier should appear as: 


Key <letter> <form> <version> - <edit> <patch> 


where the following Key letters have been identified: 


Vv released or frozen version 
X in-house experimental version 
Y field test, pre-release, or in-house release version 


and 'v' to company support. 


Use the dash that separates version from edit only if edit or patch is 
not null. When a version identifier is displayed as part of a program 
identification, the format is: 


Program 

<space><key-letter><form><version>-<edit><patch> 
Name 
Examples: 

PIP X03 


LINK VB04-C 
MACRO Y05-01 
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B.1.10.2 Use of the Version Number in the Program - All sources must 
contain the version number in an .IDENT directive. For programs (or 
libraries) that consist of more than one module, each individual 
module follows this version number standard. The version number of 
the program or library is not necessarily related to the version 
numbers of the consituent modules; it is perfectly reasonable, for 
example, that the first version of a new FORTRAN library, V00, contain 
an existing SIN routine, say V05-01. 


Parameter files are also required to contain the version number in an 
-IDENT directive. Because the assembler records the last .IDENT seen, 
parameter files must precede the program. 


Entities that consist of a collection of modules or programs (for 
example, the FORTRAN library) have an identification module in the 
first position. An identification module exists solely to provide 
identification and normally consists of something like: 


;OTS IDENTIFICATION 
eTITLE FTNLIB 
~-IDENT /003010/ 

- END 


B.1.11 Co-routines 


In some cases, two program routines are highly interactive. They then 
use a special case of the JSR instruction ( JSR PC,@(SP)+ ). This 
form of the JSR instruction exchanges the top element of the stack and 
the contents of the program counter (PC). In this way, two routines 
May Swap program control and resume operation where they stopped, when 
recalled. Such routines are called co-routines. 


This swapping of control is illustrated below with an actual sequence 
of instructions from RSX-11M Executive code (Version 3.1). 


CODE ACTION STACK 


SDRECP:: 
‘ Address of caller CALLER ADR 
of SDRECP > 


CALLR $NXTSK 


(1) (JMP SNXTSK) (1) PC=Address of SNXTSK 
SNXTSK:: STACK 
SAVNR 
(1) (JSR R5,$SAVNR) (1) Push R5 contents onto 
stack (save R5). 
(2) MOV P.MAIN(RO) ,R5 Put address of next 


instruction (2) into R5 
(return address). 

Put address of SSAVNR 
into PC. 
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SSAVNR:: 
(1) MOV R4, (SP) (1) 
(2) MOV R5, (SP) (2) 
(3) MOV 4(SP),R5 (3) 
(4) CALL @(SP)+ 
(JSR PC,@(SP)+) (4) 


(5) MOV (SP)+,R4 
(6) MOV (SP)+,R5 
(7) RETURN 

(RTS PC) 


SNXTSK:: 
SAVNR 
(1) MOV P.MAIN(RO),R5 (1) 


(2) 


(2) RETURN 
(RTS PC) 


SSAVNR:: 
. (5) 
(5) MOV (SP)+,R4 (6) 
(6) MOV (SP)+,R5 (7) 
(7) RETURN 
(RTS PC) 
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Save R4 on stack 

Save R5 on stack 
Restore saved R5 from 
the stack into R5 

Pop “call to" address 
(address of step (2) in 
SNXTSK) into PC. 

Push address of next 
instruction (5) onto 
stack. 


Start SNXTSK processing 
here. 

Pop address of (5), in 
SSAVNR, into PC. 


Pop saved R4 into R4. 

Pop saved R5 into R5. 

Return to caller of 
SDRECP. 


STACK 


CALLER ADR 


(5) 


STACK 


CALLER ADR 
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MACRO EXPANSIONS 


C.1 COMMAND STRING INTERPRETER MACRO EXPANSIONS 


C.1.1 CSIS$1 Macro 
This macro calls the command string syntax analyzer. 


~-MACRO CSIS$1 CSBLK,BUFF,LEN 
-GLOBL .CSI1 

-MCALL CSI$,LDROS 

-IF NDF C.SIZE 

CSI$ 

»ENDC 

LDRO$ CSBLK 

-IF NB <BUFF> 

MOV BUFF,C.CMLD+2 (RO) 
-ENDC 

-IF NB <LEN> 

MOV LEN,C.CMLD (RQ) 
»ENDC 

JSR PC,.CSI1 

-ENDM 


C.1.2 CSI$2 Macro 
This macro calls the command string semantic parser. 


«MACRO CSI$2 CSBLK,IO,SWTAB 
-GLOBL .CSI2 

-MCALL CSI$,LDRO$ 

-IF NDF C.SIZE 


CSIs 

-ENDC 

LDRO$ CSBLK 
-IF NB <IO> 


~-IF IDN <INPUT>,<IO> 
MOVB #CS.INP, (RO) 
-IFF 

-IF IDN <OUTPUT> ,<IO> 
MOVB #CS.OUT, (RO) 


LFF 
» ERROR ;Incorrect request to .CSI2 


- ENDC 
- ENDC 
-ENDC 


c=] 
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-IF NB <SWTAB> 

MOV SWTAB,C.SWAD (RO) 
»ENDC 

JSR PC,.CSI2 

-ENDM 


C.1.3 CSISSW Macro 
This macro defines the switch table entry. 


-MACRO CSISSW SW,MK,MKW,CLR,NEGS,VALTAB,LNG 


~IF B,SW 

- ERROR 

~IFF 

- EVEN 

-NCHR SI2Z$$,SW 
-IF GT,SI2Z$$-2 
-IF B,LNG 
SIZ$S$=2 

»ENDC 

-ENDC 

CNTS$=0 

-IRPC CHRSS$S,SW 
CHRS$$=''CHRSSS$ 
CNTSS=CNTSS$+1 


~IF GE,<CHRSS$-<'A+"040>> 
-IF LE,<CHRS$-<'Z+"040>> 


CHRSS=CHRS$$-*040 
-ENDC 

.~ENDC 

-IF LE,CNTS$-S1ZS$$ 
$,=0 

.IF NB,LNG 

-IF IDN,<LNG> ,<EXACT> 
.IF GT,CNTSS&1 

.IF  GE,CNTSS+1-S12$$ 
$$="0200 

.ENDC 

.IFF 

~IF LT,CNTSS$S-SI1Z$$ 
$$="0200 


.ENDC 
.ENDC 

-IFF 

IF IDN,<LNG> , <LONG> 
~IF EQ,CNTSS$&1 

.IF LT,CNTS$-S1Z$S$ 
$$=°O20 


» ENDC 
» ENDC 
-IFF 

- ERROR 


» ENDC 
» ENDC 
- ENDC 
» BYTE 
-ENDC 
«ENDM 
- EVEN 


CHRSS!S$ 


;Missing switch name 


;Force to word alignment 

;Set SIZS$ to no. of chars in sw 
;I£ string is longer than 2 chars 
sand not "long" or “exact" 

trim it back to 2 characters 


For each character in SW 


sIf .GE. lower case A 
» and .LE. lower case Z 
3; convert to upper case alpha 


:If£ more characters to store 


7I1£ "long" or "exact" 

sIf “exact" 

and if first byte of word 

and if last word in switch name 
then set the exact match flag 


=e ue fe 


If 2nd byte of word 

and if not the last character 
set the "more ASCII words 
coming" bit 


=e "8 “NO tO 


;End of “if first byte of word" 
;If not "exact" 

;Must be "long", otherwise error 
;If 2nd byte of word 

; and not the last character 

; set the "more ASCII words 

3 coming" bit 


s;If not "long" 
Illegal "long" or 
; specifier 

s;End of if "long" 
End of if "exact" 
sEnd of IF NB,LNG 
sGenerate a character 

sEnd of "if more characters" 
7;End of the IRPC loop 

;Round up to next word boundary 


"exact" 
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- ENDC ;End of .IF B,SW 
-IF NB MK 

»WORD MK 

-IFF 

»WORD 0 

- ENDC 


~LF NB CLR 

IF IDN <CLEAR> ,<CLR> 
$$=1 

-IFF 

~IF IDN <SET>,<CLR> 

-IFF 

- ERROR ;Invalid set/clear spec 

~ENDC 

-ENDC 

« ENDC 

-WORD MKW+SS 
$$=0 

-IF NB NEGS 

IF IDN <NEG>,<NEGS> 


~-lFF 

~ERROR s;Invalid negate spec 
~ENDC 

»ENDC 

«WORD VALTAB+S$ 

~ENDM 


C.1.4 CSISND Macro 
This macro defines the end of the switch value table end. 


-MACRO CSISND 
-WORD 0 
-ENDM 


C.1.5 CSISSV Macro 
This macro defines the switch value table entry. 


»-MACRO CSISSV TYPE,ADDR,LEN,VALTAB 
~IF NB VALTAB 
VALTAB: 
~ENDC 
IF NB TYPE 
-IF IDN <ASCII>,<TYPE> 
~BYTE 1 
-IFF 
-IF IDN <NUMERIC>,<TYPE> 
-BYTE 2 
~IFF 
-IF IDN <OCTAL> ,<TYPE> 
~-BYTE 2 
~lFF 
e-IF IDN <DECIMAL> ,<TYPE> 
-BYTE 3 
~IFF 
» ERROR ;Invalid conversion type 
-ENDC 
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-ENDC 

- ENDC 
-ENDC 

~IFF 

-BYTE 1 

. ENDC 

-IF NB LEN 
-BYTE LEN 
-IFF 

- ERROR 
-BYTE 0 

- ENDC 

-IF NB ADDR 
»WORD ADDR 
iLeF 

- ERROR 
-WORD Q 

- ENDC 
-ENDM 


C.1.6 LDROS Macro 


sASCII conversion assumed 


;Length missing 


;Value address missing 


This macro conditionally loads RO. 


-MACRO LDROS ARG 

-IIF B,ARG,.MEXIT 
-NTYPE PARSSS ,ARG 
-IIF EQ,PARSS$,.MEXIT 
MOV ARG,RO 

.ENDM 


C.1.7 CSIS$ Macro 


This macro defines command string interpreter symbols. 


.MACRO CSI$ GBL 
“IF IDN <GBL>,<DEFS$G> 


-GLOBL C.TYPR,C.STAT,C.CMLD,C.DEVD,C.DIRD,C.FILD,C.SWAD 


-GLOBL C.MKW1,C.MKW2 


-GLOBL C.SIZE,C.DSDS,CS.INP,CS.OUT 
-GLOBL CS.NMF,CS.DIF,CS.DVF,CS.WLD,CS.MOR,CS .EQU 


-ENDC 
C.TYPR=0 
C.STAT=1 
C.CMLD=2 


C.DEVD=6 


C.DIRD="0<12> 


C.FILD="0<16> 


C.SWAD="0<22> 
C.MKW1="0<24> 


;Reguest type (for CSI2) 

;Status (from CSI2) 

Length of command string buffer 
;Address of command string buffer 
;Length of device name string 
;Address of most recent device 

; name string 

;Length of most recent DIR info 
;Address of DIR info 

;Length appropriate to C.FILD+2 
;CSI1 - address of string seg 

; where error occurred 

7;CSI2 - address of file name for 
; Current request 

sAddress of current switch table 
;OR of masks for all switches 

; found this call 


C.MKW2="0<26> 
C.SIZE="0<54> 
C.DSDS=C.DEVD 


7C.TYPR VALUES 
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;On/off settings of masks for 

3; Switches found 

;Size of CSI control block (in 

; bytes) 

;Displacement to 6 word block for 
+ FCS 


CS.INP=1 ;Request input string 

CS .OUT=2 ;Request output string 

7C.STAT VALUES 

CS .NMF=1 ;1 = File name specified this seg 
; of string 

CS .DIF=2 ;1 = Dir info specified this seg 
; of string 

CS .DVF=4 371 = Device name specified this 
; seg of string 

CS.WLD="0<10> ;File name has wild card switch 

CS.MOR="0<20> ;More string segs follow 

CS.EQU="0<40> ;Equal sign seen by CSI1 


C.2 DIRECTIVE MACRO EXPANSIONS 


-MACRO CALL ADR 
JSR PC,ADR 
»~ENDM CALL 
-MACRO RETURN 
RTS PC 

-ENDM RETURN 


-MACRO CALLR ADR 
JMP ADR 
-ENDM CALLR 


C.2.1 ABRTSC Macro 


ABRTSC generates a DPB for the ABORT TASK directive in a separate 
PSECT followed by an EMT 377 in the user specified PSECT. 


Macro call: ABRTSC TSK,PSCT,ERR 


Description: ABRTSC generates a DPB for the ABORT TASK directive in 
the separate SDPBS$ program section and generates an EMT 377 in the 
program section specified by PSCT. TSK, the task name, is the only 
argument required for the DPB definition. The optional argument, ERR, 
must be a valid assembler destination operand specifying an error 
routine address. Because this routine invokes ABRT$, the same factors 
govern the expansion of code and symbolic offsets. 


»-MACRO ABRTSC TSK,PSCT,ERR 

-MCALL ABRTS ,DIR$ 

.IF NDF $S$SGLB 

-PSECT S$DPBS$$ 
$$$=. 

~IFTF 

ABRTS TSK 

-IFT 

.PSECT PSCT 

DIRS #$$$,ERR 

»ENDC 

-ENDM ABRTSC 
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C.2.2 ABRTSS Macro 


ABRT$S pushes a DPB for the ABORT TASK directive on the stack and 
generates an EMT 377. 


Macro call: ABRTSS NAMADR,ERR 


Description: ABRTSS pushes a DPB for the ABORT TASK directive on the 
stack. The argument, NAMADR, must be a valid assembler operand that 
yields the address of a double-word with the task name in RADIX-50. 
ABRTSS then generates an EMT 377 and considers the optional argument, 
ERR, the error routine address. 


-MACRO ABRTSS NADR,ERR 
-MCALL RFAS ,DIRS$ 

RFAS NADR 

MOV (PC) +,-(SP) 

-BYTE 83.,3 

DIRS ,ERR 

-ENDM ABRTSS 


C.2.3 ABRTS Macro 
The ABRT$S macro generates a DPB for the ABORT TASK directive. 
Macro call: ABRTS TSK 


Description: This macro creates a DPB for the ABORT TASK directive. 
The argument, TSK, is the name of the task to be aborted. 


This macro defines the following symbolic offset: 
A.BTTN-(length is 4 bytes) Task name. 


The ABRT$ macro generates the A.BTTN symbolic offset only when the 
SS$GLB is defined. The symbol, A.BTTN, is a global symbol in this 
case. 


-MACRO ABRTS TSK 
-MCALL R50$,OFFS 
-IF NDF S$SSGLB 
-BYTE 83.,3 

R50$ TSK 

~ENDC 

-IF NDF A.BTTN 
»NLIST 

OFFS 

OFFS A.BTTN,4 
.LIST 

~ENDC 

-ENDM ABRTS 


C.2.4 ALTPSC Macro 

The ALTPSC macro generates a DPB for the ALTER TASK PRIORITY directive 
in a separate PSECT followed by an EMT 377 in the user specified 
PSECT. 


Macro call: ALTPSC TTASK,NPRIO,PSCT,ERR 
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Description: This macro generates a DPB for the ALTER TASK PRIORITY 
directive in the programsection named $DPBS$. The DPB parameters are 
described in the ALTPS macro. Then the macro generates an EMT 377 in 
the program section named in PSCT. The DIRS macro describes the ERR 
error service address, The ALTPS macro controls symbolic offset 
generation. 


-MACRO ALTPSC TTASK,NPRIO,PSCT,ERR 
~MCALL ALTPS ,DIRS$ 
-IF NDF SSSGLB 
»PSECT S$DPBS$ 
~IFTF 

ALTPS TTASK,NPRIO 
IFT 

»PSECT PSCT 

DIRS #$S8$,ERR 
.ENDC 

-ENDM ALTPSC 


C.2.5 ALTPSS Macro 


The ALTPSS macro generates the code to push a DPB for the ALTER TASK 
PRIORITY directive on the stack followed by EMT 377. 


Macro call: ALTP$S NAMADR,NPRIO,ERR 


Description: This macro generates the code to push a DPB for ALTER 
TASK PRIORITY on the stack. The argument, TNAMADR, must be a valid 
assembler source operand that yields the address of a double-word 
containing the RADIX-50 name specified in the ALTPS macro. The macro 
then generates an EMT 377. The DIR$ macro describes the ERR error 
service address. 


»-MACRO ALTPSS NAME,PRI,ERR 
-MCALL MOVS,RFAS ,DIRS 

MOVS PRI 

RFAS NAME 

MOV (PC)+,-(SP) 

-BYTE 9.,4 

DIRS ,ERR 

-ENDM ALTPSS 


C.2.6 ALTP$ Macro 
The ALTPS macro generates a DPB for the ALTER TASK PRIORITY directive. 
Macro call: ALTP$ TTASK,NPRIO 


Description: This macro generates a DPB for the ALTER TASK PRIORITY 
directive. The arguments are assumed to have the following meanings: 


TTASK=Name of target task for new priority 
NPRIO=New priority for task 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 


A.LTTN-(length 4 bytes) target task name, 
T,LTPR-(length 2 bytes) new priority 
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If the macro is invoked with the $$S$GLB symbol defined, the ALTP$ 
macro does not generate the DPB and ALTPS defines the offsets as 
global symbols. 


»MACRO ALTPS NAME,PRI 
-MCALL R50S ,OFFS 
-IF NDF SSS$GLB 
-BYTE 9.,4 

R50$ NAME 

eWORD PRI 

»ENDC 

-IF NDF A.LTTN 
-NLIST 

OFF$ 

OFFS A.LTIN,4 
OFFS A.LTPR,2 
»LIST 

«ENDC 

-ENDM ALTPS 


C.2.7 ALUNSC Macro 


The ALUNSC macro generates a DPB for the ASSIGN LUN directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 


Macro Call: ALUNSC LUN,DEVNAM,DEVNUM,PSCT,ERR 


Description: This macro generates a DPB for the ASSIGN LUN directive 
in the program section named SDPB$$. The arguments through DEVNUM are 
the DPB parameters as described for the ALUNS macro. The macro then 
generates an EMT 377 in the program section as specified by PSCT. The 
argument, ERR is as described for the DIRS macro. For an explanation 
of symbolic offsets, see the ALUNS macro. 


-MACRO ALUNSC LUN,DA,DU,CS,ERR 
-MCALL ALUNS ,DIRS 

-IF NDF $SSGLB 

»-PSECT SDPBSS$ 


$$$=. 
-IFTF 
ALUNS$ LUN,DA,DU 
-IFT 
-PSECT CS 
DIRS #$$$,ERR 
- ENDC 


~-ENDM ALUNSC 


C.2.8 ALUNSS Macro 


The ALUNSS macro generates the code to push a DPB for the ASSIGN LUN 
directive on the stack followed by an EMT 377. 


Macro call: ALUNSS LUN,DEVNAM,DEVNUM,ERR 


Description: This macro generates the code to push a DPB for. the 
ASSIGN LUN directive on the stack. The arguments through DEVNUM must 
be valid assembler source operands, and they must specify the DPB 
parameters listed in the ALUNS macro. The DIRS macro describes the 
ERR argument. 
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»MACRO ALUNSS LUN,DA,DU,ERR 
»-MCALL MOVS ,DIRS 

MOVS DU 

MOVS DA 

MOVS LUN 

MOV (PC)+,-(SP) 

~-BYTE 7,4 

DIRS ,ERR 

-ENDM ALUNSS 


C.2.9 ALUNS Macro 
The ALUNS macro generates a DPB for the ASSIGN LUN directive. 
Macro call: ALUNS LUN,DEVNAM,DEVNUM 


Description: This macro creates a DPB for the ASSIGN LUN directive. 
‘The arguments are assumed to have the following meanings: 


LUN=Logical unit number, 
DEVNAM=Physical device name (two characters), 
DEVNUM=Physical device unit number. 


The following symbols are locally defined with their assigned values 
egual to the byte offset from the start of the DPB to the respective 
DPB elements: - 7 


A.LULU-(length 2 bytes) Logical unit number, 
A.LUNA-(2) Physical device name, 
A.LUNU-(2) Physical device unit number. 


If the macro is invoked with the symbol, S$SSGLB, defined, ALUNS does 
not generate the DPB and ALUNS defines the offsets as global symbols. 


»-MACRO ALUNS LUN,DA,DU 
-MCALL OFFS 

-IF NDF S$S$SGLB 

-BYTE 7,4 

-WORD LUN 

.IF B <DA> 

~WORD 0 

.IFF 

~-NCHR $S$S$T1,<DA> 


S$$$T2=. 

-ASCII /DA/ 
-=$S$T2+2 

~ENDC 

»WORD DU 

-ENDC 

-IF NDF A.LULU 

-NLIST 

-IRP X,<,<A.LULU,2>,<A.LUNA,2>,<A.LUNU,2>> 

OFFS X 

.ENDM 

-LIST 

-ENDC 

-ENDM ALUNS 
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C.2.10 ASTXSC Macro 


The ASTXSC macro generates a DPB for the AST SERVICE EXIT directive in 
a separate PSECT followed by an EMT 377 in the user specified program 
PSECT. 


Macro call: ASTX$SC PSCT,ERR 


Description: This macro generates a DPB for the AST SERVICE EXIT 
directive in the program section named SDPB$S$. The argument, PSCT, is 
the program section in which to generate an EMT 377. The DIRS macro 
describes the ERR argument. 


»MACRO ASTXSC PSCT,ERR 

-MCALL ASTXS ,DIRS 

-IF NDF $$S$GLB 

~PSECT SDPBS$ 
$$$=, 

~IFTF 

ASTXS$ 

~IFT 

-PSECT PSCT 

DIRS #$$$,ERR 

~ENDC 

»ENDM ASTXSC 


C.2.11 ASTX$S Macro 


The ASTX$S macro generates the code to push a DPB for the AST SERVICE 
EXIT directive on the stack followed by an EMT 377. 


Macro call: ASTXSS ERR 


Description: This macro generates the code to push a DPB for the AST 
SERVICE EXIT directive on the stack. Then a MONITOR TRAP is 
generated. The error routine address argument, ERR, results in an an 
unconditional call following the EMT because control should never be 
returned on the AST exit. 


ACRO ASTXS$S ERR 
-MCALL DIRS 
MOV (PC) +,-(SP) 
~BYTE 115.,1 
DIRS 
-IIF NB <ERR>, JSR PC,ERR 
-ENDM ASTXSS 


C.2.12 ASTX$ Macro 
The ASTX$ macro generates a DPB for the AST SERVICE EXIT directive. 
Macro Call: ASTXS 


Description: This macro creates a DPB for the AST SERVICE EXIT 
directive. It takes no arguments. 
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Note: If the symbol, $S$GLB, is defined, this macro does not generate 
any code, 


-MACRO ASTXS 
-IF NDF S$SSGLB 
-BYTE 115.,1 
~ENDC 
-ENDM ASTXS 


C.2.13 CINTSC Macro 


The CINTSC macro generates a DPB in a separate PSECT for the CONNECT 
TO INTERRUPT VECTOR directive followed by an EMT 377 in the user 
specified PSECT. 


Macro call: CINTSC VEC,BASE,ISR,DSI,PSW,AST,PSCT,ERR 


Description: CINT$C generates a DPB in the program section named 
SDPBS$ for the CONNECT TO INTERRUPT VECTOR directive. CINTS describes 
the the DPB parameters. CINT$C then generates an EMT 377 in the 
program section named in PSCT. The DIRS macro describes the ERR error 
service address. 


»-MACRO CINTSC VEC,BASE,ISR,DSI,PSW,AST,PSCT,ERR 
-MCALL CINTS ,DIRS 
-IF NDF $S$SGLB 
»-PSECT SDPBSS 
$$$=, 
-IFTF 
CINTS VEC,BASE,ISR,DSI,PSW,AST 
-IFT 
-PSECT PSCT 
DIRS #$$$,ERR 
»ENDC 
-ENDM CINTSC 


C.2.14 CINTS$S Macro 


The CINTSS macro generates the code to push a DPB on the stack for the 
CONNECT TO INTERRUPT VECTOR directive followed by an EMT 377. 


Macro call: CINTS$S VEC,BASE,ISR,DSI,PSW,AST,ERR 


Description: CINTSS generates the code to push a DPB for the CONNECT 
TO INTERRUPT VECTOR directive on the stack. The DPB arguments must be 
valid assembler source operands and then must specify the information 
described in the CINTS macro. The macro, RVP$, pushes the arguments 
on the stack in reverse order. CINTSS also generates an EMT 377 and 
uses the ERR error service address as described in the DIRS macro. 


-MACRO CINT$S VEC,BASE,ISR,DSI,PSW,AST,ERR 
-MCALL RVP$,DIR$ 

RVPS$ VEC,BASE,ISR,DSI,PSW,AST 

MOV (PC)+,-(SP) 

»BYTE 129.,7 

DIRS ,ERR 

-ENDM CINTSS 
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C.2.15 CINTS Macro 
‘CINTS generates a DPB for the CONNECT TO INTERRUPT VECTOR directive. 
Macro call: CINTS VEC,BASE,ISR,DS5I,PSW,AST 


Description: CINT$ generates a DPB for the CONNECT TO INTERRUPT 
VECTOR directive. The arguments are assumed to have the following 
meanings: 


VEC = Must be in the range 60(8) through the highest vector 
specified during SYSGEN, and must be a multiple of 4. 


BASE = Virtual base address for kernel APR 5 mapping of the ISR, 
and enable/disable interrupt routines -- This address is 
automatically truncated to a 32(10)-word boundary. The 
"base" argument is ignored in an unmapped system. 


ISR = Virtual address of the ISR, or 0 to disconnect from the 
interrupt vector. 


DSI = Virtual address of the enable/disable interrupt routine. 
PSW = Initial priority at which the ISR is to execute -- 
This is normally equal to the hard-wired interrupt 
priority, and is expressed in the form n*40, where n is a 
number in the range 0-7. This form puts the value in bits 
5-7 of pri. It is recommended that the programmer make 
use of the symbols PR4, PR5, PR6, and PR? for this 
purpose. These are implemented via the macro HWDDFS found 
in [1,1] EXEMC.MLB. AST = Virtual address of an AST 
routine to be entered after the fork level routine queues 
an AST. 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 


C.INVE -- Vector address (2) 


C.INBA -- Base address (2) 

C.INIS -- ISR address (2) 

C.INDI -- Enable/disable interrupt routine address (2) 
C.INPS -- Priority (2) 


C.INAS -- AST address (2) 


If the macro is invoked with the $SS$SGLB symbol defined, the CINTS 
Macro does not generate the DPB and CINTS defines the offsets as 
global symbols. 


-MACRO CINTS VEC,BASE,ISR,DSI,PSW,AST 
-MCALL OFFS 
-IF NDF SSSGLB 
sBYTE 129.7 
»WORD VEC 
-WORD BASE 
.WORD ISR 
-WORD DSI 
-WORD PSW 
-WORD AST 
.ENDC 

-IF NDF C.INVE 
OFFS 

OFFS C.INVE,2 
OFFS C.INBA,2 
OFFS C.INIS,2 
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OFF$ C.INDI,2 
OFFS C.INPS,2 
OFFS C.INAS,2 
»ENDC 

~-ENDM CINTS 


C.2.16 CLEFSC Macro 


The CLEF$C macro generates a DPB for the CLEAR EVENT FLAG directive in 
a separate PSECT followed by an EMT 377 in the user specified program 
PSECT. 


Macro call: CLEFSC EFN,PSCT,ERR 


Description: This macro generates a DPB for the CLEAR EVENT FLAG 
directive in the SDPBSS$ program section. The CLEF$ macro describes 
the DPB parameters. This macro then generates an EMT 377 in the 
program section named in PSCT. The DIRS macro describes the ERR error 
service address. The CLEFS macro controls symbolic address 
generation. 


»-MACRO CLEFSC EFN,CS,ERR 
-MCALL CLEFS ,DIRS 

-IF NDF $SSGLB. 

»-PSECT S$DPBS$ 


$$$=, 
-IFTF 
CLEF$ EFN 
~IFT 
-PSECT CS 
DIRS #$$5$,ERR 
-ENDC 


»-ENDM CLEFSC 


C.2.17 CLEFS$S Macro 


The CLEFSS macro generates the code to push a DPB for the CLEAR EVENT 
FLAG directive on the stack followe by an EMT 377. 


Macro call: CLEFS$SS EFN,ERR 


Description: This macro generates the code to push a DPB for the 
CLEAR EVENT FLAG directive on the stack. The DPB arguments must be 
valid assembler source operands, and they must specify the information 
described in the CLEFS macro. This macro also generates a monitor 
trap, uSing the error service address, ERR, as described in the DIR$ 
macro. 


-MACRO CLEFSS EFN,ERR 
-MCALL MOVS ,DIRS$ 

MOVS EFN 

MOV (PC)+,-(SP) 

-BYTE 31.,2 

DIRS ,ERR 

-ENDM CLEFSS 
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C.2.18 CLEF$ Macro 


The CLEF$ macro generates a DPB for the CLEAR EVENT FLAG directive. 
Macro call: CLEFS EFN 


Description: This macro generates a DPB for the CLEAR EVENT FLAG 
directive. The argument is assumed to have the following meaning: 


EFN=EVENT FLAG NUMBER. 


The following symbol is lecally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element: 


C.LEEF-(length 2 bytes) Event flag number. 


If the macro is invoked with the symbol, S$$GLB, defined, CLEFS$ does 
not generate the DPB and CLEFS defines the offset as a global symbol. 


-MACRO CLEFS EFN 
»MCALL OFFS 
-IF NDF $SSGLB 
»BYTE 31.,2 
~WORD EFN 
.ENDC 

.IF NDF C.LEEF 
.NLIST 

OFFS 

OFFS C.LEEF,2 
-LIST 

.ENDC 

~ENDM CLEFS 


C.2.19 CMKTSC Macro 


The CMKTSC macro generates a DPB for the CANCEL MARK-TIME REQUESTS 
directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 


Macro Call: CMKTSC EFN,AST,PSCT,ERR 


Description: This macro generates a DPB for the CANCEL MARK-TIME 
REQUESTS directive in the $DPB$$ program section. The CMKTSS macro 
describes the DPB parameters. Then the macro generates an EMT 377 in 
the program section named in the PSCT argument. The DIRS macro 
describes the ERR error service address. 


-MACRO CMKTSC EFN,AST,PSCT,ERR 

.MCALL CMKTS ,DIRS 

.IF NDF $SSGLB 

-PSECT S$DPBSS$ 
$$$=, 

~IFTF 

CMKTS EFN,AST 

.IFT 

»PSECT PSCT 

DIRS #$$$,ERR 

»ENDC 

-ENDM CMKTSC 
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C.2.20 CMKTSS Macro 


The CMKT$S macro generates the code to push a DPB for the CANCEL 
MARK~TIME REQUESTS directive on the stack followed by an EMT 377. 


Macro call: CMKTSS EFN,AST,ERR 


Description: This macro generates the code to push a DPB for the 
CANCEL MARK-TIME REQUESTS directive on the stack. The DPB arguments 
must be valid assembler source operands, and they must specify the 
information described in the CMKTS macro. The macro also generates an 
EMT 377. The DIRS macro describes the ERR error service address. 


Note: The EFN and AST arguments are required to maintain 
compatibility with RSX-11D. Despite the fact that they must be 
specified, the CMKTSS macro ignores them. 


»MACRO CMKTSS EFN,AST,ERR 
-MCALL DIRS 

MOV (PC)+,-(SP) 

-BYTE 27.,1 

DIRS ,ERR 

~-ENDM CMKTSS 


C.2.21 CMKTS Macro 


The CMKTS macro generates a DPB for the CANCEL MARK-TIME REQUESTS 
directive. 


Macro call: CMKTS EFN,AST 


Description: This macro generates a DPB for the CANCEL MARK-TIME 
REQUESTS directive. 


Note: The EFN and AST arguments are required to maintain 
compatibility with RSX-11D. Despite the fact that they must be 
specified, the CMKT$ macro ignores them. If the $S$SGLB symbol is 
defined, this macro does not generate any code. 


-MACRO CMKTS EFN,AST 
-IF NDF S$SSSGLB 

~-BYTE 27.,1 

-ENDC 

-ENDM CMKTS 


C.2.22 CSROQSC Macro 


The CSRQ$C macro generates a DPB for the CANCEL SCHEDULED REQUESTS 
directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 


Macro call: CSROQSC TTASK,RTASK,PSCT,ERR 


Description: This macro generates a DPB for the CANCEL SCHEDULED 
REQUESTS directive in the $DPBSS program section. The DPB parameters 
are described in the CSRQ$ macro. Then the macro generates an EMT 377 
in the original program section named in PSCT. The DIRS macro 
describes the ERR error service address. The CSRQS$ macro controls 
symbolic address generation. 


MACRO EXPANSIONS 


Note: Read the discussion notice concerning ignored arguments in the 
CSRQ$ macro below. 


-MACRO CSROQSC TT,RT,CS,ERR 
-MCALL CSRQS ,DIRS 

-IF NDF SSSGLB 

-PSECT SDPBSS$ 


$$$. 
.IFTF 
CSROQO$ TT,RT 
-IFT 
-PSECT CS 
DIRS #$$$,ERR 
« ENDC 


-ENDM CSROSC 


C.2.23 CSRQSS Macro 


The CSRQ$S macro generates the code to push a DPB for the CANCEL 
SCHEDULED REQUESTS directive on the stack followed by an EMT 377. 


Macro call: CSRQS$S TNAMADR,RNAMADR,ERR 


Description: This macro generates the code to push a DPB for CANCEL 
SCHEDULED REQUESTS on the stack. The TNAMADR and RNAMADR arguments 
must be valid assembler source operands that yield the addresses of 
double-words containing the RADIX-50 names’ specified in the CSRQ$ 
Macro. The macro then generates an EMT 377. The DIRS macro describes 
the ERR error service address. 


Note: Read the discussion notice concerning ignored arguments in the 
CSRQS macro below. 


~-MACRO CSRQSS TN,RN,ERR 
-MCALL RFAS$ ,DIRS 

RFAS TN 

MOV (PC) +,-(SP) 

~BYTE- 25.43 

DIRS ,ERR 

-ENDM CSROSS 


C.2.24 CSRQ$ Macro 


The CSRQS$ macro generates a DPB for the CANCEL SCHEDULED REQUESTS 
directive. 


Macro call: CSRQ$ TTASK,RTASK 

Description: This macro generates a DPB for the CANCEL SCHEDULED 
REQUESTS directive. The arguments are assumed to have the following 
meanings: 


TTASK=Scheduled (target) task name, 
RTASK=Scheduler (requester) task name. 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 

C.SRTN-(length 4 bytes) target task name, 

C.SRRN-(4) requester task name. 
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If the macro is invoked with the $$SGLB symbol defined, CSRQS$ does not 
generate the DPB and it globally defines the symbolic offsets. 


Note: The RTASK argument is required to maintain compatibility with 
RSX-11D. Despite the fact that it must be specified, the CSRQ$ macro 
ignores it. 


»MACRO CSROS TT,RT 
»MCALL R50S$ ,OFFS 
-IF NDF $$$GLB 
-BYTE 25.,3 

R50$ TT 

»ENDC 

-IF NDF C.SRIN 
-NLIST 

OFFS 

OFFS C.SRITN,4 
OFFS C.SRRN,4 
.LIST 

.ENDC 

-ENDM CSRQS 


C.2.25 DECLSC Macro 


The DECLSC macro generates a DPB for the DECLARE SIGNIFICANT EVENT 
directive in a separate PSECT followed by an EMT 377 in the user 
specified program section. 


Macro call: DECLSC EFN,PSCT,ERR 


Description: This macro generates a DPB for the DECLARE SIGNIFICANT 
EVENT directive in the $DPBS$ program section. This macro also 
generates an EMT 377 in the user specified program section, PSCT, with 
the ERR error service address as described in the DIRS macro. 


Note: The EFN argument is required to maintain compatibility with 
RSX-11D. Despite the fact that it must be specified, the DECLSC macro 
ignores it. 


-MACRO DECLSC EFN,PSCT,ERR 

.MCALL DECLS ,DIRS 

-IF NDF $$S$GLB 

-PSECT SDPBSS 
$$$=, 

.IFTF 

DECLS EFN 

~IFT 

-PSECT PSCT 

DIRS #$$$,ERR 

-ENDC 

-ENDM DECLSC 


C.2.26 DECLS$S Macro 


The DECLSS macro generates the code to push a DPB for the DECLARE 
SIGNIFICANT EVENT directive on the stack followed by an EMT 377. 


Macro call: DECLSS EFN,ERR 
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Description: This macro generates the code to push a DPB for the 
DECLARE SIGNIFICANT EVENT directive on the stack. The DPB arguments 
must be valid assembler source operands, and they must specify the 
information described in the DECL$ macro. This macro also generates 
an EMT 377, using the ERR error service address as described in the 
DIRS macro. 


Note: The EFN argument is required to maintain compatibility with 
RSX-11D. Despite the fact that it must be specified, the DECL$ macro 
ignores it. 


-MACRO DECLSS EFN,ERR 
-MCALL DIRS 

MOV (PC)+,-(SP) 

-BYTE 35.,1 

DIRS ,ERR 

~ENDM DECLSS 


C.2.27 DECLS Macro 


The DECLS macro generates a DPB for the DECLARE SIGNIFICANT EVENT 
directive. 


Macro call: DECLS EFN 


Description: This macro generates a DPB for the DECLARE SIGNIFICANT 
EVENT directive. DECLS ignores the EFN argument but EFN must be 
present to maintain compatibility with RSX-11D. 


»MACRO DECLS EFN 
-IF NDF SSSGLB 
-BYTE 35.,1 
-ENDC 

»ENDM DECLS 


C.2.28 DIRS Macro 


DIRS generates an RSX-11M directive call (EMT 377) with a pre-defined 
DPB. 


Macro call: DIRS ADR,ERR 


Description: The argument, ADR, must be a valid assembler’ source 
operand. It pushes the DPB address on the stack. DIRS then generates 
an EMT 377 to trap to the Executive. The argument, ERR, is optional. 
If ERR is defined, it must be a valid assembler destination operand to 
permit the execution of a JUMP TO SUBROUTINE instruction to an error 
handler if the directive CALL fails. 


»MACRO DIRS ADR,ERR 

-IF NB <ADR> 

MOV ADR,-(SP) 

»ENDC 

EMT *“0<377> 

-LIF NB <ERR>, .MCALL ERRS 
-IIF NB <ERR>, ERRS ERR 
-ENDM DIRS 
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C.2.29 DSARSC Macro 


The DSARSC macro generates the DPB for the DISABLE AST RECOGNITION 
directive in a separate program section followed by an EMT 377 in the 
user specified PSECT. 


Macro call: DSARSC PSCT,ERR 


Description: This macro generates a DPB for the DISABLE AST 
RECOGNITION directive in the PSECT SDPB$$ followed by an EMT 377 in 
the program section specified in PSCT. The DIRS macro describes’ the 
ERR error service address. 


»MACRO DSARSC PSCT,ERR 

-MCALL DSARS ,DIRS 

-IF NDF SSSGLB 

-PSECT SDPBSS$ 
$$$=, 

~IFTF 

DSARS 

IFT 

.PSECT PSCT 

DIRS #$$$,ERR 

»ENDC 

.ENDM DSARSC 


C.2.30 DSARSS Macro 


The DSARSS macro generates the code to push a DPB for the DISABLE AST 
RECOGNITION directive on the stack followed by an EMT 377. 


Macro call: DSARSS ERR 


Description: This macro generates the code to push a one-word DPB for 
the DISABLE AST RECOGNITION directive on the stack. Then the macro 
generates an EMT 377, using the ERR error service address, described 
in the DIRS macro. 


-MACRO DSARSS ERR 
-MCALL DIR$ 

MOV (PC)+,-(SP) 
-BYTE 99.,1 

DIRS ,ERR 

-ENDM DSARSS 


C.2.31 DSARS$ Macro 


The DSARS macro generates a DPB for the DISABLE AST RECOGNITION 
directive. 


Macro call: DSARS 


Description: This macro generates a DPB for the DISABLE AST 
RECOGNITION directive. 


-MACRO DSARS 
-IF NDF $$SGLB 
-BYTE 99.,1 
.-ENDC 

-ENDM DSARS 
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C.2.32 DSCPSC Macro 


The DSCPSC macro generates a DPB for the DISABLE CHECKPOINTING 
directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 


Macro call: DSCPSC PSCT,ERR 


Description: This macro generates a DPB for the DISABLE CHECKPOINTING 
directive in the S$DPBS$$ program section and an EMT 377 in the user 
specified PSCT program section. The DIRS macro describes the ERR 
error service address. 


-MACRO DSCPSC PSCT,ERR 

-MCALL DSCPS$ ,DIRS 

-IF NDF $$SGLB 

-PSECT S$DPBS$$ 
$$$=, 

~IFTF 

DSCPS$ 

IFT 

»PSECT PSCT 

DIRS #5$$,ERR 

-ENDC 

-ENDM DSCPSC 


C.2.33 DSCPSS Macro 


The DSCPS$S macro generates the code to push a DPB for the DISABLE 
CHECKPOINTING directive on the stack followed by an EMT 377. 


Macro call: DSCPSS ERR 


Description: This macro generates the code to push a one-word DPB for 
the DISABLE CHECKPOINTING directive on the stack. Then an EMT 377 is 
generated, using the ERR error service address, as described in the 
DIRS macro. 


-MACRO DSCPSS ERR 
-MCALL DIRS 

MOV (PC)+,-(SP) 
~-BYTE 95.,1 

DIRS ,ERR 

.ENDM DSCPSS 


C.2.34 DSCPS Macro 


The DSCPS macro generates a DPB for the DISABLE CHECKPOINTING 
directive. 


Macro call: DSCPS$ 


Description: This macro generates a DPB for the DISABLE CHECKPOINTING 
directive. There are no arguments. 


-MACRO DSCPS 
-IF NDF SSSGLB 
~BYTE 95.,1 

» ENDC 

-ENDM DSCPS$ 
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C.2.35 ENARSC Macro 


The ENARSC macro generates a DPB for the ENABLE AST RECOGNITION 
directive in a separate PSECT, followed by an EMT 377 in the user 
specified PSECT. 


Macro call: ENARSC PSCT,ERR 


Description: This macro generates a DPB for the ENABLE AST 
RECOGNITION directive in the SDPB$$ program section followed by an EMT 
377 in the program section named in PSCT. The DIRS macro describes 
the ERR error service address. 


-MACRO ENARSC PSCT,ERR 

-MCALL ENARS ,DIRS 

-IF NDF S$S$SGLB 

-PSECT SDPBS$ 
$$$=, 

~IFTF 

ENARS 

~IFT 

-PSECT PSCT 

DIRS #$$$,ERR 

.ENDC 

-ENDM ENARSC 


C.2.36 ENARSS Macro 


The ENARSS macro generates the code to push a DPB for the ENABLE AST 
RECOGNITION directive on the stack followed by an EMT 377. 


Macro call: ENARSS ERR 


Description: This macro generates the code to push a one-word DPB for 
the ENABLE AST RECOGNITION directive on the stack. Then an EMT 377 is 
generated using the ERR error service address as described in the DIRS 
macro, 


-MACRO ENARSS ERR 
-MCALL DIRS 

MOV (PC)+,-(SP) 
»~BYTE 101.,1 

DIRS ,ERR 

-ENDM ENARSS 


C.2.37 ENARS Macro 


The ENARS macro generates a DPB for the ENABLE AST RECOGNITION 
directive. 


Macro call: ENARS 


Description: This macro generates a DPB for the ENABLE AST 
RECOGNITION directive. There are no parameters. 


MACRO ENARS 
-IF NDF S$SGLB 
~BYTE 101.,1 
.-ENDC 

-ENDM ENARS 
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C.2.38 ENCPSC Macro 


The ENCPSC macro generates a DPB for the ENABLE CHECKPOINTING 
directive in a separate PSECT followed by an EMT 377 in the user 
specified program PSECT. 


Macro call: ENCPSC PSCT,ERR 


Description: This macro generates a DPB for the ENABLE CHECKPOINTING 
directive in the $DPBS$ program section. Then the macro generates an 
EMT 377 in the program section named in PSCT. The DIRS macro 
describes the ERR error service address. 


-MACRO ENCPSC PSCT,ERR 

-MCALL ENCPS ,DIRS$ 

-IF NDF $S$S$GLB 

»PSECT S$DPBS$ 
$$$=., 

~IFTF 

ENCPS 

~IFT 

-PSECT PSCT 

DIRS #$$$,ERR 

-ENDC 

-ENDM ENCPSC 


C.2.39 ENCPSS Macro 


The ENCP$SS macro generates the code to push a DPB for the ENABLE 
CHECKPOINTING directive on the stack followed by an EMT 377. 


Macro call: ENCPSS ERR 


Description: This macro generates the code to push a one-word DPB for 
the ENABLE CHECKPOINTING directive on the stack. Then an EMT 377 is 
generated using the ERR error service address as described in the DIR$ 
macro. 


~MACRO ENCPSS ERR 
-MCALL DIRS 

MOV (PC)+,-(SP) 
~-BYTE 97.,1 

DIRS ,ERR 

-ENDM ENCPSS 


C.2.40 ENCP$ Macro 


The ENCPS macro generates a DPB for the ENABLE CHECKPOINTING 
directive. 


Macro call: ENCPS$ 


Description: This macro generates a DPB for the ENABLE CHECKPOINTING 
directive. There are no parameters 


~MACRO ENCPS 
-IF NDF $S$S$GLB 
~-BYTE 97.,1 
-ENDC 

-ENDM ENCPS 
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C.2.41 ERRS Macro 


ERRS is an internal macro that generates a test for directive failure 
accompanied by a JSR instruction to an error handler. 


Macro call: ERRS ERR 


Description: A set C-bit indicates directive failure. If the ERR 
argument is defined, ERR$ generates code to test the C-bit and skip if 
not set followed by a JSR to an error handler specified by ERR. 


-MACRO ERRS ERR 

.IF NB <ERR> 

-NLIST 

-NTYPE $$$T1,ERR 

.LIST 

~IIF EQ “O<$$$T1-27>, BCC .+6 
eLIF EQ “O<S$S$T1-37>, BCC .+6 
-IF GE “O0<SSS$T1-60> 

BCC .+6 

.IFF 

-IF NE “0<S$S$$T1-27> 

-IIF NE *O<$$$T1-37>, BCC .+4 
~ENDC 

-ENDC 

CALL ERR 

-ENDC 

.ENDM ERRS 


C.2.42 EXIFSC Macro 


THE EXIFSC macro generates a DPB for the EXIT IF directive in a 
separate PSECT followed by an EMT 377 in the user specified program 
PSECT. 


Macro call: EXIFSC EFN,PSCT,ERR 


Description: This macro generates a DPB for the EXIT IF directive in 
the S$DPB$$ program section. The DPB parameters are described in the 
EXIFS macro. This macro then generates an EMT 377 in the program 
section named in PSCT. The DIRS macro describes the ERR error service 
address. The EXIF$ macro controls symbolic address generation. 


-MACRO EXIFSC EFN,CS,ERR 
-MCALL EXIFS ,DIRS 

-IF NDF $SSGLB 

-PSECT SDPBSS$ 


$$$=. 
~IFTF 
EXIF$ EFN 
-IFT 
~PSECT CS 
DIRS #$$$,ERR 
» ENDC 


~-ENDM EXIFSC 
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C.2.43 EXIFSS Macro 


The EXIFSS macro generates the code to push a DPB for the EXIT IF 
directive on the stack followed by an EMT 377. 


Macro call: EXIFSS EFN,ERR 


Description: This macro generates the code to push a DPB for the EXIT 
IF directive on the stack. The DPB arguments must be valid assembler 
source operands, and they must specify the information described in 
the EXIF$ macro. This macro also generates an EMT 377 using the ERR 
error service address as described in the DIRS macro. 


-MACRO EXIFSS EFN,ERR 
»MCALL MOVS ,DIRS 

MOVS EFN 

MOV (PC)+,-(SP) 

-BYTE 53.,2 

DIRS ,ERR 

-ENDM EXIFSS 


C.2.44 EXIF$ Macro 
The EXIFS macro generates a DPB for the EXIT IF directive. 
Macro call: EXIFS EFN 


Description: This macro generates a DPB for the EXIT IF directive. 
The argument is assumed to have the following meaning: 


EFN=Event flag number. 


The following symbol is locally defined with its assigned values equal 
to the byte offset from the start of the DPB to the DPB element: 


E.XFEF-(length 2 bytes) Event flag number. 


If the macro is invoked with the symbol SSSGLB defined, EXIFS does not 
generate the DPB and it globally defines the symbolic offset. 


»-MACRO EXIFS EFN 
»MCALL OFFS 
-IF NDF SSSGLB 
~-BYTE 53.,2 
-WORD EFN 
-ENDC 

.IF NDF E.XFEF 
-NLIST 

OFFS 

OFFS E.XFEF,2 
«List 

»ENDC 

-ENDM EXIFS 


C.2.45 EXITSC Macro 


The EXITSC macro generates a DPB for the TASK EXIT directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 


Macro call: EXITSC PSCT,ERR 
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Description: This macro generates a DPB in the program SECTION SDPBS$ 
followed by an EMT 377 in the PSCT program section. The DIRS macro 
describes the ERR error service address. 


-MACRO EXITSC PSCT,ERR 

»MCALL EXITS ,DIRS 

-IF NDF SSSGLB 

-PSECT SDPBS$ 
$$S$=, 

-IFTF 

EXITS 

IFT 

-PSECT PSCT 

DIRS #$$$,ERR 

~ENDC 

~ENDM EXITSC 


C.2.46 EXITSS Macro 


The EXITSS macro generates the code to push a DPB for the TASK EXIT 
directive on the stack followed by an EMT 377. 


Macro call: EXITSS ERR 


Description: This macro generates the code to push a one-word DPB for 
the TASK EXIT directive on the stack. Then, EXIT$S generates an EMT 
377 using the ERR error service address, as described in the EXITS 
macro. 


-MACRO EXITSS ERR 
»MCALL DIRS 

MOV (PC)+,~-(SP) 

-BYTE 51.,1 

DIRS 

-IIF NB <ERR>, CALL ERR 
»ENDM EXITSS 


C.2.47 EXITS Macro 
The EXITS macro generates a DPB for the TASK EXIT directive. 


Macro call: EXITS 


Description: This macro generates a DPB for the TASK EXIT directive. 
There are no parameters. 


.MACRO EXITS 
-IF NDF $S$SGLB 
-BYTE 51.,1 
»ENDC 

-ENDM EXITS 


C.2.48 EXTKSC Macro 


The EXTK$C macro generates a DPB for the EXTEND TASK directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 


Macro call: EXTKSC INC,PSCT,ERR 
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Description: This macro generates a DPB for the EXTEND TASK directive 
in the S$DPBS$ program section. The DPB parameters are described in 
the EXTK$ macro. This macro then generates an EMT 377 in the program 
section named in PSCT. The DIR$ macro describes the ERR error service 
address. The EXTKS macro controls the generation of symbolic offsets. 


-MACRO EXTKSC INC,CS,ERR 

-MCALL EXTKS ,DIR$ 

~IF NDF $S$GLB 

»-PSECT SDPBS$ 
$$$=. 

~IFTE 

EXTKS INC 

IFT 

-PSECT CS 

DIRS #$$$,ERR 

.-ENDC 

»ENDM EXTKSC 


C.2.49 EXTKSS Macro 


EXTKSS pushes a DPB for the EXTEND TASK directive on the stack and 
generates an EMT 377. 


Macro call: EXTKSS INC,ERR 


Description: EXTKSS pushes a DPB for the EXTEND TASK directive on the 
stack. The DPB arguments must be valid assembler operands and they 
Must specify the information that the EXTKS macro describes. EXTKSS 
also generates an EMT 377 using the ERR error service address that the 
DIRS macro describes. 


-MACRO EXTKSS INC,ERR 
-MCALL MOVS ,DIRS 

CLR -(SP) 

MOVS INC 

MOV (PC)+,-(SP) 

~-BYTE 89.,3 

DIR$ ,ERR 

»ENDM EXTKSS 


C.2.50 EXTK$ Macro 
The EXTK$ macro generates a DPB for the EXTEND TASK directive. 
Macro call: EXTKS INC 


Description: EXTK$S generates a DPB for the EXTEND TASK directive. 
The argument must have the following meaning: 


INC=Task size increment in 32 word blocks. 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element: 


E.XTIN-(length 2 bytes) Task size increment. 
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If EXTK$ is invoked with the S$$SGLB symbol defined, EXTK$ does not 
generate the DPB and it globally defines symbolic offsets. 


.MACRO EXTKS INC 
.MCALL OFFS 
-IF NDF $SSGLB 
-BYTE 89.,3 
-WORD INC 
-WORD 0 

.ENDC 

.IF NDF E.XTIN 
-NLIST 

OFFS 

OFFS E.XTIN,2 
.LIST 

.ENDC 

-ENDM EXTKS 


C.2.51 GLUNSC Macro 


GLUNSC generates a DPB for the GET LUN INFORMATION directive in a 
separate PSECT followed by an EMT 377 in the user specified program 
PSECT. 


Macro call: GLUNS$C LUN,BUFADR,PSCT,ERR 


Description: GLUNSC generates a DPB for the GET LUN INFORMATION 
directive in the S$DPBSS$ program section and generates an EMT 377 in 
the program section named in PSCT. GLUNS describes the DPB parameters 
and controls symbolic address generation. The DIRS macro describes 
the ERR error service address, 


»MACRO GLUNSC LUN,BUFA,CS,ERR 

.MCALL GLUNS ,DIRS 

-IF NDF S$SS$GLB 

-PSECT SDPBSS$ 
$$$=. 

.IFTF 

GLUNS LUN,BUFA 

IFT 

-PSECT CS 

DIRS #$$$,ERR 

»ENDC 

.ENDM GLUNSC 


C.2.52 GLUNSS Macro 


GLUNSS generates the code to push a DPB for the GET LUN INFORMATION 
directive on the stack and generates an EMT 377. 


Macro call: GLUN$S LUN,BUFADR,ERR 


Description: GLUNSS generates the code to push a DPB for the GET LUN 
INFORMATION directive on the stack and generates an EMT 377 by using 
the ERR error service address as described in the DIR$ macro. GLUNSS 
also generates symbolic offsets relative to the information buffer as 
described in the GLUNS macro. DPB arguments must be valid assembler 
source operands and must specify the information described in the 
GLUNS macro. 
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.MACRO GLUNSS LUN,BUFA,ERR 
-MCALL MOVS ,DIRS ,OFFS 
MOVS BUFA 
MOVS LUN 
MOV (PC)+,-(SP) 
~BYTE 5,3 
DIRS ,ERR 
.IF NDF G.LUNA 
-NLIST 
$SSOST=0 
~IRP X,<<G.LUNA,2>,<G.LUNU,1>,<G.LUFB,1>,<G.LUCW,8.>> 
OFFS X 
-ENDM 
-LIST 
-ENDC 
-ENDM GLUNSS 


C.2.53 GLUNS$ Macro 
The GLUNS macro generates a DPB for the GET LUN INFORMATION directive. 
Macro call: GLUNS$ LUN,BUFADR 


Description: This macro generates a DPB for the GET LUN INFORMATION 
directive. The arguments are assumed to have the following meaning: 


LUN=Logical unit number, 
BUFADR=Address of six-word buffer. 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 


G.LULU-(length 2 bytes) Logical unit number, 
G.LUBA-(2) Buffer address, 
G.LUBL-(2) Buffer length. 


The following symbols are assigned relative to the start of the LUN 
information buffer: 


G.LUNA-(2) Device name, 

G.LUNU-(1) Device unit number, 

G.LUFB-(1) Flags byte, 

G.LUCW-(8) Four device characteristic words. 


If the macro is invoked with the $$GLB symbol defined, GLUNS does not 
generate the DPB and it globally defines the symbolic offsets. 


»-MACRO GLUNS LUN,BUFA 

-MCALL OFFS$ 

-IF NDF $$S$GLB 

-BYTE 5,3 

-WORD LUN 

-WORD BUFA 

~ENDC 

-IF NDF G.LULU 

-NLIST 

~IRP X,<,<G.LULU,2>,<G.LUBA,2>,<G.LUBL,2>> 

OFFS X 

-ENDM 

-IF NDF G.LUNA 
SSSOST=0 
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-IRP X,<<G.LUNA,2>,<G.LUNU,1>,<G.LUFB,1>,<G.LUCW,8.>> 
OFFS X 

-ENDM 

»ENDC 

-LIST 

- ENDC 

~ENDM GLUNS 


C.2.54 GMCRSC Macro 


GMCRSC generates a DPB for the GET MCR COMMAND LINE directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 


Macro call: GMCRSC PSCT,ERR 


Description: GMCRSC generates a DPB for the GET MCR COMMAND LINE 
directive in the $DPBS$$ program section and generates an EMT 377 in 
the program section named in PSCT. GMCRS describes the DPB parameters 


and controls symbolic address generation. DIR$ describes the ERR 
error service address. 


»MACRO GMCRSC CS,ERR 

-MCALL GMCRS ,DIRS 

~IF NDF $SSGLB 

-PSECT SDPBSS$ 
$$$=, 

~IFTF 

GMCRS$ 

aiet 

-PSECT CS 

DIRS #S$$,ERR 

-ENDC 

-ENDM GMCRSC 


C.2.55 GMCRS$ Macro 


The GMCRS macro generates a DPB for the GET MCR COMMAND LINE 
directive. 


Macro call: GMCR$ 


Description: This macro generates a DPB for the GET MCR COMMAND LINE 
directive. GMCR$ locally defines the following symbol with its 


assigned value equal to the byte offset from the start of the DPB to 
the DPB element: 


G.MCRB-(length 80 bytes) MCR line buffer 


If the macro is invoked with the $$$GLB symbol defined, GMCR$ does not 
generate the DPB and it globally defines the symbolic offset. 


»MACRO GMCRS 
»-MCALL OFFS 
-IF NDF $$S$GLB 
BYTE 127.,41. 
-BLKW 40. 
.ENDC 

-IF NDF G.MCRB 
-NLIST 

OFFS 
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OFFS G.MCRB,80. 
»LIST 

«ENDC 

*.ENDM GMCRS 


C.2.56 GPRTSC Macro 


GPRTSC generates a DPB for the GET PARTITION PARAMETERS directive ina 
separate PSECT followed by an EMT 377 in the user specified PSECT. 


Macro call: GPRTSC PRTINAM,BUFADR,PSCT,ERR 


Description: GPRT$C generates a DPB for the GET PARTITION PARAMETERS 
directive in the SDPBS$$ program section and generates an EMT 377 in 
the program section named in PSECT. GPRTS describes the DPB 
parameters and controls symbolic offset generation. DIRS describes 
the ERR error service address. 


.MACRO GPRTSC PRT,BUF,CS,ERR 

-MCALL GPRTS ,DIRS 

-IF NDF $S$SGLB 

»PSECT S$DPBS$ 
$$S=. 

~IFTF 

GPRTS PRT,BUF 

IFT 

-PSECT CS 

DIRS #$$$,ERR 

»ENDC 

.ENDM GPRTSC 


C.2.57 GPRTSS Macro 


GPRTSS generates the code to push a DPB for the GET PARTITION 
PARAMETERS directive on the stack and generates an EMT 377. 


Macro call: GPRT$S PRTNAMADR,BUFADR,ERR 


Description: GPRTSS generates the code to push a DPB for the GET 
PARTITION PARAMETERS directive on the stack and generates an EMT 377 
using the ERR error service address described in the DIRS macro. The 
DPB arguments must’ be valid assembler source operands and they must 
specify the information described in the GPRTS macro. GPRT$S also 
generates symbolic offsets relative to the start of the partition 
parameters buffer described in the GPRTS$ macro. 


-MACRO GPRTSS PRT,BUF,ERR 
.MCALL MOVS ,RFAS ,DIRS ,OFFS$ 
MOVS BUF 
RFAS$ PRT 
MOV (PC) +,-(SP) 
-BYTE 65.,4 
DIRS ,ERR 
-IF NDF G.PRPB 
-NLIST 
$$SOsST=0 
.IRP X,<<G.PRPB,2>,<G.PRPS,2>,<G.PRFW,2>> 
OFFS X 
.ENDM 
-LIST 
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~ENDC 
-ENDM GPRTSS 


C.2.58 GPRTS Macro 


The GPRTS macro generates a DPB for the GET PARTITION PARAMETERS 
directive. 


Macro call: GPRTS PRTNAM,BUF 


Description: This macro generates a DPB for the GET PARTITION 
PARAMETERS directive. The arguments are assumed to have the following 


meanings: 


PRINAM=Partition name, 
BUFADR=Address of three word buffer. 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 


G.PRPN-(length 4 bytes) Partition name, 
G.PRBA-(2) Buffer address. 


The following offsets are assigned relative to the start of the 
partition parameters buffer: 


G.PRPB-(2) 1/64 Partition base address, 
G.PRPS-(2) 1/64 Partition size, 
G.PRFW-(2) Partition flags word. 


If GPRTS$ is invoked with the $S$GLB symbol defined, GPRTS does not 
generate the DPB and it globally defines the symbolic offsets. 


.MACRO GPRTS PRT,BUF 
-MCALL OFFS ,R50$ 
-IF NDF $SS$GLB 
~-BYTE 65.,4 
R50$ PRT 
.WORD BUF 
.ENDC 
.IF NDF G.PRPN 
-NLIST 
OFFS 
OFFS G.PRPN,4 
OFFS G.PRBA,2 
.IF NDF G.PRPB 
$SSOST=0 
~IRP X,<<G.PRPB,2>,<G.PRPS,2>,<G.PRFW,2>> 
OFFS X 
~ENDM 
»ENDC 
-LIST 
- ENDC 
-ENDM GPRTS 
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C.2.59 GSSWSC Macro 


The GSSWSC macro generates a DPB for the GET SENSE SWITCHES directive 


in a separate PSECT followed by an EMT 377 in the user specified 
PSECT. 


Macro call: GSSWSC PSCT,ERR 


Description: This macro generates a DPB for the GET SENSE SWITCHES 
directive in the S$DPBSS program section followed by an EMT 377 in the 
user specified program section PSCT. The DIRS macro describes the ERR 
error service address. 


«MACRO GSSWSC PSCT,ERR 

-MCALL GSSWS$ ,DIRS 

-IF NDF $SSGLB 

»-PSECT SDPBS$ 
$$$=, 

-IFTF 

GSSWS 

IFT 

-PSECT PSCT 

DIRS #$$$,ERR 

~ENDC 

-ENDM GSSWSC 


C.2.60 GSSWSS Macro 


The GSSWSS macro generates the code to push a DPB for the GET SENSE 
SWITCHES directive on the stack followed by an EMT 377. 


Macro call: GSSWSS ERR 


Description: This macro generates the code to push a one-word DPB for 
the GET SENSE SWTICHES directive on the stack. Then it generates an 
EMT 377 using the error service address as described in the DIRS 
macro, 


-MACRO GSSWSS ERR 
-MCALL DIRS 

MOV (PC) +,-(SP) 
~-BYTE 125.,1 

DIRS ,ERR 

-ENDM GSSWSS 


C.2.61 GSSWS Macro 


The GSSWS macro generates a DPB for the GET SENSE SWITCHES directive. 
Macro call: GSSWS 


Description: This macro generates a DPB for the GET SENSE SWITCHES 
directive. There are no arguments. 


~MACRO GSSWS$ 
IF NDF $$$GLB 
-BYTE 125.,1 
»ENDC 

-ENDM GSSWS$ 
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C.2.62 GTIMSC Macro 


The GTIM$C macro generates a DPB for the GET TIME PARAMETERS directive 
in a separate PSECT followed by an EMT 377 in the user specified 
PSECT. 


Macro call: GTIMSC BUFADR,PSCT,ERR 


Description: This macro generates a DPB for the GET TIME PARAMETERS 
directive in the SDPBS$ program section. The GTIMS macro describes 
the DPB parameters, This macro then generates an EMT 377 in the 
program section named in PSCT. The DIR$ macro describes the ERR error 
service address. The GTIMS macro controls symbolic address 
generation. 


-MACRO GTIMSC BUFA,CS ERR 

-MCALL GTIMS ,DIRS 

-IF NDF S$SSGLB 

»-PSECT SDPBSS$ 
SSS, 

~IFTF 

GTIMS$ BUFA 

IFT 

-PSECT CS 

DIRS #$$$,ERR 

-ENDC 

-ENDM GTIMSC 


C.2.63 GTIMSS Macro 


The GTIMSS macro generates the code to push a DPB for the GET TIME 
PARAMETERS directive on the stack followed by an EMT 377. 


Macro call: GTIMSS BUFADR,ERR 


Description: This macro generates the code to push a DPB for the GET 
TIME PARAMETERS directive on the stack. The DPB arguments must be 
valid assembler source operands, and they must specify the information 
described in the GTIMS macro. This macro also generates an EMT 377 
using the ERR error service address, as described in the DIRS macro. 
This macro also generates symbolic offsets relative to the time 
parameters buffer as described in the GTIMS$ macro. 


-MACRO GTIMSS BUFA,ERR 
-MCALL MOVS ,DIRS ,OFFS 
MOVS BUFA 
MOV (PC) +,-(SP) 
~-BYTE 61.,2 
DIRS ,ERR 
.IF NDF G.TIYR 
-NLIST 
$$SOST=0 
~IRP X,<<G.TIYR,2>,<G.TIMO,2>,<G.TIDA,2>,<G.TIHR,2>> 
OFFS X 
»ENDM 
-IRP X,<<G.TIMI,2>,<G.TISC,2>,<G.TICT,2>,<G.TICP,2>> 
OFFS X 
-ENDM 
-LIST 
»ENDC 
-ENDM GTIMSS 
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C.2.64 GTIMS Macro 
The GTIMS macro generates a DPB for the GET TIME PARAMETERS directtve. 
Macro call: GTIMS BUFADR 


Description: This macro generates a DPB for the GET TIME PARAMETERS 
directive. The argument is assumed to have the following meaning: 


BUFADR=Address of eight word buffer. 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the element: 


G.TIBA-(length 2 bytes) Buffer address. 


The following offsets are assigned relative to the start of the time 
parameters buffer: 


G.TIYR-(2) Year, 

G.TIMO-(2) Month, 

G.TIDA-(2) Day, 

G.TIHR-(2) Hour, 

G.TIMI-~(2) Minute, 

G.TISC~(2) Second, 

G.TICT-(2) Clock tick, 

G.TICP-(2) Clock ticks per second. 


If GTIMS is invoked with the S$$GLB symbol defined, GTIMS does not 
generate the DPB and it globally defines the symbolic offsets. 


-MACRO GTIMS BUFA 

-MCALL OFFS 

-IF NDF SSS$GLB 

-BYTE 61.,2 

-WORD BUFA 

.ENDC 

.IF NDF G.TIBA 

-NLIST 

OFFS 

OFFS G.TIBA,2 

.IF NDF G.TIYR 
$$SOST=0 

-IRP X,<<G.TIYR,2>,<G.TIMO,2>,<G.TIDA,2>,<G.TIHR,2>> 

OFFS X 

.ENDM 

-IRP X,<<G.TIMI ,2>,<G.TISC,2>,<G.TICT,2>,<G.TICP,2>> 

OFFS X 

.ENDM 

-ENDC 

-LIST 

-ENDC 

-ENDM GTIMS 


C.2.65 GTSKSC Macro 

The GTSKSC macro generates a DPB for the GET TASK PARAMETERS directive 
in a separate PSECT followed by an EMT 377 in the user specified 
PSECT. 


Macro call: GTSKSC BUFADR,PSCT,ERR 
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Description: This macro generates a DPB for the GET TASK PARAMETERS 
directive in the SDPBSS program section. The GTSKSS macro describes 
the DPB parameters. This macro then generates an EMT 377 in the 
Original program control section named in PSCT. The DIRS macro 
describes the ERR error service address. The GTSKS macro controls 
symbolic offset generation. 


-MACRO GTSKSC BUFA,CS,ERR 

-MCALL GTSKS$ ,DIRS 

.IF NDF $$SGLB 

»-PSECT SDPBSS 
$$$=, 

IFT 

GTSKS BUFA 

IFT 

-PSECT CS 

DIRS #$$$,ERR 

»ENDC 

»ENDM GTSKSC 


C.2.66 GTSK$SS Macro 


The GTSKSS macro generates the code to push a DPB for the GET TASK 
PARAMETERS directive on the stack followed by an EMT 377. 


Macro call: GTSK$S BUFADR,ERR 


Description: GTSKSS generates the code to push a DPB for the GET TASK 
PARAMETERS directive on the stack. The DPB arguments must be valid 
assembler source operands and they must specify the information 
described in the GTSKS macro. GTSKSS generates an EMT 377 using the 
ERR error service address, as described in the DIRS macro. GTSKSS 
also generates symbolic offsets relative to the task parameters buffer 
as described in the GTSKS$ macro. 


-MACRO GTSKSS BUFA,ERR 
-MCALL MOVS ,DIRS ,OFFS 
MOVS BUPA 
MOV (PC)+,-(SP) 
-BYTE 63.,2 
DIRS ,ERR 
-IF NDF G.TSTN 
»NLIST 
$$SOST=0 
-IRP X,<<G.TSTN,4>,<G.TSPN,4>,<G.TSRN,4>,<G.TSPR,2>,<G.TSPC,1>> 
OFFS X 
.ENDM 
-IRP X,<<G.TSGC,1>,<G.TSNL,2>,<G.TSMT,2>,<G.TSFW,2>,<G.TSVA,2>> 
VL,2 
OFFS G.TSTS,2 
OFFS G.TSSY,2 
OFFS G.TSDU,2 
$$SOST=0 
-IRP X,<<RX$11D,1>,<RX$11M,1>,<RX$11S,1>,<RXSIAS,1>> 
OFFS X 
-ENDM 
«LIST 
~ENDC 
~-ENDM GTSKSS 
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C.2.67 GTSKS Macro 
The GTSKS macro generates a DPB for the GET TASK PARAMETERS directive. 
Macro call: GTSKS$ BUFADR 


Description: 
directive. 


GTSKS generates a DPB for the GET TASK PARAMETERS 
The argument is assumed to have the following meaning: 


BUFADR=Address of a 16 word buffer. 


The following symbol is locally defined with its assigned value equal 

to the byte offset from the start of the DPB to the DPB element: 
G.TSBA~(length 2 bytes) Buffer address. 

The following offsets are assigned relative to the start of the task 


parameters buffer: 


G.TSTN-(4) Task name 

G.TSPN-(4) Partition name 

G.TSRN-(4) Name of task's requester 

G.TSPR-(2) Priority 

G.TSGC-(1) UIC group code 

G.TSPC-(1) UIC programmer code 

G.TSNL-(2) Number of logical units 

G.TSMT-(2) Machine type 

G.TSFW-(2) Std flags word 

G.TSVA-(2) Address of task SST vector tabie 
G.TSVL-(2) Length (number of words) of task SST vector table 
G.TSTS-(2) Size (in bytes) of task address space 
G.TSSY-(2) System in which task is running: 


RX$11D - System is RSX-11D 
RXS11M - System is RSX-11M 
RX$11S - System is RSX-115 
RXSIAS - System is IAS 


G.TSDU- (2) 


If GTSKS is invoked with the S$SSGLB symbol 
generate the DPB and it globally defines the symbolic offsets. 


Task's (default) protection UIC 


defined, GTSKS does 


-MACRO GTSKS BUFA 
-MCALL OFFS 

-IF NDF S$SGLB 
»BYTE 63.,2 

-WORD BUFA 


» ENDC 


»~IF NDF G.TSBA 


eNLIST 
OFFS 


OFFS G.TSBA,2 
-IF NDF G.TSTN 


S$SOST=0 


not 


»-IRP X,<<G.TSTN,4>,<G.TSPN,4>,<G.TSRN,4>,<G.TSPR,2>,<G.TSPC,1>> 


OFFS X 
»-ENDM 


~IRP X,<<G.TSGC,1>,<G.TSNL,2>,<G.TSMT,2>,<G.TSFW,2>,<G.TSVA,2>> 


OFFS X 
~ENDM 


OFFS G.TSVL,2 
OFFS G.TSTS,2 
OFF$ G.TSSY,2 
OFFS G.TSDU,2 


$$S$ost=0 


MACRO EXPANSIONS 


-IRP X,<<RXS11D,1>,<RX$11M,1>,<RX$11S,1>,<RXSIAS,1>> 
OFFS X 

.~ENDM 

»ENDC 

.LIST 

»ENDC 

~ENDM GTSKS 


C.2.68 IHARSC Macro 


The IHARSC macro generates a DPB for the INHIBIT DISABLE AST 
RECOGNITION directive in a separate PSECT followed by an EMT 377 in 
the user specified PSECT. 


Macro call: IHARSC PSCT,ERR 


Description: This macro generates a DPB for the INHIBIT DISABLE AST 
RECOGNITION directive in the $DPB$$ program section followed by an EMT 
377 in the user specified program section named PSCT. The DIRS macro 
describes the ERR error service address. 


Note: This macro is the same as the DSARSC macro, and is’ included 
only for compatibility with RSX-11D. 


»-MACRO IHARSC PSCT,ERR 
»-MCALL DSARSC 


DSARSC PSCT,ERR 
-ENDM IHARSC 


C.2.69 IHARSS Macro 


The IHARSS macro generates the code to push a DPB for the INHIBIT AST 
RECOGNITION directive on the stack and an EMT 377. 


Macro call: IHARSS ERR 
Description: This macro generates the code to push a one-word DPB for 
the DISABLE AST RECOGNITION directive on the stack. Then the macro 
generates an EMT 377 using the ERR error service address described in 
the DIRS macro. 
Note: This macro is included only for compatibility with RSX-11D. 
»~MACRO IHARSS ERR 
»MCALL DSARSS 


DSARSS ERR 
-ENDM IHARSS 


C.2.70 IHARS$ Macro 


The IHARS macro generates a DPB for the INHIBIT DISABLE AST 
RECOGNITION directive. 


Macro call: IHARS$ 


Description: This macro generates a DPB for the INHIBIT DISABLE AST 
RECOGNITION directive. There are no parameters. 


C-37 
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Note: This macro is included only for compatiblity with RSX-11D. 


-MACRO IHARS 
-MCALL DSARS 
DSARS 

~-ENDM IHARS 


C.2.71 MOVS Macro 


This is an internal macro that pushes an argument on the stack. 
Macro call: MOVS <ARG> 


Description: MOVS pushes an argument on the stack. MOVS examines the 
argument first to determine which code is valid to perform the push. 
If the argument is left blank, MOVS uses a CLR instruction. 
Otherwise, MOVS generates a "MOV ARG,-(SP)" instruction. 


-MACRO MOVS ARG 
-IF NB <ARG> 

-IF DIF <ARG>,<#0> 
MOV ARG,- (SP) 
»MEXIT 

~ENDC 

~ENDC 

CLR -(SP) 

-ENDM MOVS 


C.2.72 MRKTSC Macro 


The MRKTSC macro generates a DPB for the MARK TIME directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 


Macro call: MRKTSC EFN,TIMMAG,TIMUNIT,AST,PSCT,ERR 


Description: This macro generates a DPB for the MARK TIME directive 
in the S$DPBSS program section. The MRKTS macro describes the DPB 
Parameters. This macro then generates an EMT 377 in the program 
section named in PSCT. The DIRS macro describes the ERR error service 
address. The MRKTS$ macro controls the generation of symbolic offsets. 


-MACRO MRKTSC EF,TM,TU,AST,CS,ERR 

-MCALL MRKTS ,DIRS 

~IF NDF SS$S$GLB 

~PSECT $DPBS$ 
$$$. 

-IFTF 

MRKTS EF,TM,TU,AST 

-IFT 

»PSECT CS 

DIRS #$$$,ERR 

- ENDC 

~ENDM MRKTSC 
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C.2.73 MRKTSS Macro 


The MRKTSS macro generates the code to push a DPB for the MARK TIME 
directive on the stack followed by an EMT 377. 


Macro call: MRKT$S EFN,TIMMAG,TIMUNIT,AST,ERR 


Description: This macro generates the code to push a DPB for the MARK 
TIME directive on the stack. The DPB arguments must be valid 
assembler source operands and they must specify the information 
described in the MRKTS macro. This macro also generates an EMT 377 
using the ERR error service address as described in the DIRS macro. 


»-MACRO MRKTSS EF,TM,TU,AST,ERR 
-MCALL RVPS$ ,DIRS 

RVPS EF,TM,TU,AST 

MOV (PC) +,-(SP) 

~-BYTE 23.,5 

DIR$ ,ERR 

-ENDM MRKTS$S 


C.2.74 MRKT$ Macro 
The MRKTS macro generates a DPB for the MARK TIME DIRECTIVE. 
Macro call: MRKTS EFN,TIMMAG,TIMUNIT,AST 


Description: This macro generates a DPB for the MARK TIME directive. 
The arguments are assumed to have the following meanings: 


EFN=Event flag number, 
TIMMAG=Time interval magnitude, 
TIMUNIT=Time interval unit, 
AST=AST entry address. 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 


M.KTEF-(length 2 bytes) Event flag, 
M.KTMG-(2) Time magnitude, 
M.KTUN-(2) Time unit, 

M.KTAE~(2) AST entry address. 


If MRKTS is invoked with the $$$GLB symbol defined, MRKTS does not 
generate the DPB and globally defines the symbolic offsets. 


-MACRO MRKTS EFN,TM,TU,AST 
«MCALL OFFS 

-IF NDF S$S$SGLB 

-BYTE 23.,5 

-WORD EFN 

-WORD TM 

-WORD TU 

-WORD AST 

~ENDC 

-IF NDF M.KTEF 

-NLIST 

-IRP X,<,<M.KTEF,2>,<M.KIMG,2>,<M.KTUN,2>,<M.KTAE,2>> 
OFFS X 

-ENDM 

LIST 
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~ENDC 
~ENDM MRKTS 


C.2.75 MVBS Macro 
MVBS is an internal macro that pushes two bytes on the stack. 
Macro call: MVBS LOWB,HIGHB 


Description: MVBS examines the two arguments and based on that 
examination generates the code to push the bytes on the stack. 


~MACRO MVBS LOW,HIGH 


-IF B <LOW> 
-IF B <HIGH> 
CLR ~(SP) 
~IFF 

CLRB - (SP) 
MOVB HIGH,1 (SP) 
» ENDC 

~IFF 

-IF B <HIGH> 
CLR -(SP) 
MOVB LOW, (SP) 
-IFF 


MOVB LOW,-(SP) 
MOVB HIGH,1(SP) 
» ENDC 

-ENDC 

-ENDM MVBS 


C.2.76 OFFS Macro 
OFFS is an internal macro that generates symbolic offsets. 
Macro call: OFFS SYMB,LEN 


Description: OFFS creates tables of symbolic offsets for the elements 
within DPBs. The first argument, SYMB, is the name of the symbol. 
The second argument, LEN, is the length of the symbol in bytes. OFFS 
adds LEN to the offset counter after OFFS makes the symbolic 
assignment. If the $S$GLB symbol is defined, OFFS makes the symbolic 
assignments global. Otherwise, OFFS makes all assignments local. 


If both SYMB and LEN are blank, OFFS initializes the offset counter to 
two (2). 


-MACRO OFFS SYMB,LEN 

.IF B <'SYMB'LEN> 
SSSOST=2 

-MEXIT 

~ENDC 

.IF NB <SYMB> 

-IF NDF SSSGLB 
SYMB=SSSOST 

-IFF 
SYMB==SSSOST 

-ENDC 

- ENDC 
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C.2.77 QDPBSS Macro 


The QDPBSS macro generates the code to push a QUEUE I/O or QUEUE I/0 
AND WAIT DPB on the stack and it generates an EMT 377. 


Macro call: QDPBS$S DIC,FNC,LUN,EFN,PRI,IOST,AST,PRMLST,ERR 


Description: This macro generates the code to push the proper QUEUE 
I/O DPB on the stack. It is meant to be called only by QIOSS, or 
QIOWSS to generate the required code to build a DPB and issue the EMT 
377. 


-MACRO QDPBSS DIC,FNC,LUN,EFN,PRI,IOST,AST,PRMLST,ERR 

»MCALL RVPS$ ,MVBS ,DIRS 

-NLIST 
$SSARG=0 

-IRP X,<PRMLST> 
SSSARG=SSSARG+1 

~ENDM 

»LIST 

~IF GT 6-SSSARG 

-REPT <6-SSSARG> 

CLR -(SP) 

~ENDR 

»ENDC 

.IIF NB <PRMLST>, RVPS PRMLST 

RVPS IOST,AST 

MVBS EFN, 

RVPS FNC,LUN 

MOV (PC)+,-(SP) 

-BYTE DIC,12. 

DIRS ,ERR 

-ENDM QDPBSS 


C.2.78 QDPBS$ Macro 
The QDPBS macro generates the QUEUE I/O or QUEUE I/O AND WAIT DPB. 
Macro call: QDPBS DIC,FNC,LUN,EFN,PRI,IOST,AST,PRMLST 


Description: This macro generates the required DPB for the specified 
QUEUE I/O directive. It is only meant to be called by the QIOS, 
QIOSC, QIOWS, OR QIOWSC macros to generate the required DPB. 


-MACRO QDPBS DIC,FNC,LUN,EFN,PRI,IOST,AST,PRMLST 
-MCALL OFFS 
~-IF NDF $$SGLB 
-BYTE DIC,12. 
-WORD FNC 
»WORD LUN 
-BYTE EFN,0 
-WORD IOST 
-WORD AST 
-NLIST 
SSSARG=0 
-LIST 
-IRP X,<PRMLST> 
-WORD X 
-NLIST 
SSSARG=SSSARG+1 
.LIST 
»ENDM 
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-IF GT 6-SSSARG 

»REPT <6-SSSARG> 

»WORD 0 

.ENDR 

»ENDC 

~ENDC 

.IF NDF Q.IOFN 

-NLIST 

~IRP X,<,<Q.IOFN,2>,<Q.IOLU,2>,<Q.IOEF,1>,<Q.IOPR,1>> 
OFFS X 

~ENDM 

»IRP X,<<Q.IOSB,2>,<Q.IOAE,2>,<Q.IOPL>> 
OFFS X 

-ENDM 

«LIST 

-ENDC 

~-ENDM QDPBS$ 


C.2.79 QIOSC Macro 


The QIO$C macro generates a QUEUE I/O DPB in a separate PSECT followed 
by an EMT 377 in the user specified PSECT. 


Macro call: QIOSC FNC,LUN,EFN,PRI,IOST,AST,PRMLST,PSECT,ERR 


Description: This macro generates the required QUEUE I/O DPB in the 
SDPB$S$ program section. All of the arguments through PRMLST are as 
described for the QIO$S macro. The PSECT argument should be the name 
of the original program program section into which the standard 
monitor trap code is generated. The optional argument, ERR, is the 
error routine address. This macro invokes QIOS and, therefore, 
follows the same expansion guidelines. 


Note: Read the note in the QIOS macro description concerning ignored 
arguments in the QIOS macro below. 


«MACRO QIOSC FNC,LUN,EFN,PRI,IOST,AST,PRMLST,PSCT,ERR 
-MCALL QDPBS$,DIRS 
-IF NDF $S$SGLB 
»PSECT SDPBS$ 
$$$=. 
~IFTF 
QDPBS 1,FNC,LUN,EFN,PRI,IOST,AST,<PRMLST> 
IFT 
.PSECT PSCT 
DIRS #$$$,ERR 
~ENDC 
-ENDM QIOSC 


C.2.80 QIOSS Macro 


The QIO$S macro generates the code to push a QUEUE I/0 DPB on the 
stack and generate an EMT 377. 


Macro call: QIO$S FNC,LUN,EFN,PRI,IOST,AST,PRMLST,ERR 


Description: This macro generates the code to push the required queue 
I/O DPB on the stack. The arguments through PRMLST represent the 
information as described in the macro QIOS. However, the arguments 
must all be valid assembler source operands. 
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Note: Read the note in the QIOS macro description concerning ignored 
arguments in the QIO$ macro below. 


«MACRO QIOSS FNC,LUN,EFN,PRI,IOST,AST,PRMLST,ERR 
-MCALL QDPBSS 

QDPBSS 1,FNC,LUN,EFN,PRI,IOST,AST,<PRMLST>,ERR 
~-ENDM QIOSS 


C.2.81 QIO$S Macro 
The QIO$S macro generates the QUEUE I/O DPB. 
Macro call: QIOS FNC,LUN,EFN,PRI,IOST,AST,PRMLST 


Description: This macro generates the required DPB specified for the 
QUEUE I/O directive. The arguments are treated as follows: 


FNC-I/O Function code, 

LUN-Logical unit number, 

EFN-Event flag number, 

PRI-Priority, 

IOST-Address of I/O status block, 

AST-Address of I/O done AST entry point 
PRMLST-Parameter list of the form <Pl,...,P6> 


All of the arguments must be valid expressions to be used in assembler 
data storage directives. The first call of this macro defines the 
following symbols and assigns, as a value, their byte offset from the 
beginning of the DPB: 


Q.IOFN-(length 2 bytes) I/O function, 
Q.IOLU-(2) Logical unit number, 

Q.IOEF-(1) Event flag number, 

Q.IOPR-(1) Priority, 

Q.IOSB-(2) Address of I/O status block, 
Q.IOAE-(2) Address of I/O done AST entry point, 
Q.IOPL-(0) Parameter list (up to 6 words). 


If the $$SGLB symbol is defined, QIOS does not generate the DPB and it 
globally defines the symbolic offsets. 


Note: The argument PRI is required to maintain compatibility with 
RSX-11D. Desite the fact that it must be specified, the QIOS macro 
ignores it. 

«MACRO QIOS FNC,LUN,EFN,PRI,IOST,AST,PRMLST 

»MCALL QDPBS 


QDPBS 1,FNC,LUN,EFN,PRI,IOST,AST,<PRMLST> 
-ENDM QIOS 


C.2.82 QIOWSC Macro 


The QIOWSC macro generates a QUEUE I/O AND WAIT DPB in a_e separate 
PSECT followed by an EMT 377 in the user specified PSECT. 


Macro call: QIOWSC FNC,LUN,EFN,PRI,IOST,AST,PRMLST,PSECT,ERR 


Description: This macro generates the required QUEUE I/O AND WAIT DPB 
in the program section named SDPBS$. All of the arguments through 


MACRO EXPANSIONS 


PRMLST are as described for the QIOWS macro. The argument PSECT 
should be the name of the original program program section into which 
the standard monitor trap code is generated. The optional argument, 
ERR, is the error routine address. 


Note: Read the note concerning ignored arguments in the QIOWS macro 
below. 


-MACRO QIOWSC FNC,LUN,EFN,PRI,IOST,AST,PRMLST,PSCT,ERR 
.MCALL QDPBS ,DIRS 
-IF NDF $SSGLB 
-PSECT $DPBSS 
$$$=, 
~IFTF 
QDPBS 3,FNC,LUN,EFN,PRI,IOST,AST,<PRMLST> 
IFT 
-PSECT PSCT 
DIRS #$$$,ERR 
-ENDC 
-ENDM QIOWSC 


C.2.83 QIOWSS Macro 


The QIOWSS macro generates the code to push a queve I/O and wait DPB 
on the stack and generate an EMT 377. 


Macro call: QIOWSS FNC,LUN,EFN,PRI,IOST,AST,PRMLST,ERR QIOWSS Macro 


Description: This macro generates the code to push the required QUEUE 
I/O AND WAIT DPB on the stack. The arguments through PRMLST represent 
the information as described in the QIOWS macro. However, the 
arguments must all be valid assembler source operands. 


Note: Read the note concerning ignored arguments in the QIOWS macro 
below, 


-MACRO QIOWSS FNC,LUN,EFN,PRI,IOST,AST,PRMLST,ERR 
-MCALL QDPBSS 

QDPBSS 3,FNC,LUN,EFN,PRI ,IOST,AST,<PRMLST>,ERR 
-ENDM QIOWSS 


C.2.84 QIOWS Macro 
The QIOWS macro generates the QUEUE I/O AND WAIT DPB. 
Macro call: QIOWS FNC,LUN,EFN,PRI,IOST,AST,PRMLST 


Description: This macro generates the required DPB specified for the 
QUEUE I/O AND WAIT directive. The arguments are treated as follows: 


FNC-I/0O function code, 

LUN-Logical unit number, 

EFN-Event flag number, 

PRI-Priority, 

IOST-Address of I/O status block, 

AST-Address of I/O done AST entry point 
PRMLST-Parameter list of the form <Pl,...,P6> . 


All of the arguments must be valid expressions to be used in assembler 
data storage directives, The first call of this macro defines the 
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following symbols and assigns, as values, their byte offset from the 
beginning of the DPB: 


Q.IOFN-(Length 2 bytes) I/O function, 
Q.IOLU-(2) Logical unit number, 

Q.IOEF-(1) Event flag number, 

Q.IOPR-(1) Priority, 

Q.IOSB-(2) Address of I/O status block, 
Q.IOAE-(2) Address of I/O done AST entry point, 
Q.IOPL~(0) Parameter list (up to 6 words). 


If the S$S$GLB symbol is defined, QIOWS does not generate the DPB and 
it globally defines the symbolic offsets. 


Note: This macro requires the PRI argument to maintain compatibility 
with RSX-11D. Despite the fact that it must be specified, QIOWS 
ignores it. 


»-MACRO QIOWS FNC,LUN,EFN,PRI,IOST,AST,PRMLST 
»-MCALL QDPBS$ 

QDPBS 3,FNC,LUN,EFN,PRI,IOST,AST,<PRMLST> 
-ENDM QIOWS 


C.2.85 R50$ Macro 
This internal macro generates a two-word RADIX-50 name. 
Macro call: R50S NAME 


Description: This macro converts the NAME argument into RADIX-50 
using the .RAD50 assembler directive. Furthermore, R50$ ensures that 
the data generated is at least two words long. 


-MACRO R50S NAME 
.NLIST 
-NCHR $SST1,NAME 
.LIST 
-IF EQ $S$T1 
-WORD 0,0 
.IFF 
-IF GT $S$$T1-6 
SSST4=.+4 
~IFTF 
»-RAD50 /NAME/ 
~IFT 
~=SS$T4 
»ENDC 
-IIF LT $$$T1-4, .WORD 0 
-ENDC 
»ENDM R50$ 


C.2.86 RCVDSC Macro 


RCVDSC generates a DPB for the RECEIVE DATA directive in a separate 
PSECT followed by an EMT 377 in the user specified PSECT. 


Macro call: RCVDSC TASK,BUFADR,PSCT,ERR 


Description: RCVD$C generates a DPB for the RECEIVE DATA directive in 
the S$DPBS$$ program section. RCVDS describes the DPB parameters. 
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RCVDSC then generates an EMT 377 in the program section named in PSCT. 
DIRS describes the ERR error service address. RCVDS controls the 
generation of symbolic offsets. 


»MACRO RCVDSC TN,BA,CS,ERR 

-MCALL RCVDS ,DIRS 

-IF NDF $SS$GLB 

-PSECT $DPBSS$ 
$$$=. 

~IFTF 

RCVDS TN,BA 

IFT 

-PSECT CS 

DIRS #$$$,ERR 

~ENDC 

»ENDM RCVDSC 


C.2.87 RCVDSS Macro 


The RCVDSS macro generates the code to push a DPB for the RECEIVE DATA 
directive on the stack followed by an EMT 377. 


Macro call: RCVDSS TSKNAMADR,BUFADR,ERR 


Description: This macro generates the code to push a DPB for the 
RECEIVE DATA directive on the stack. The DPB arguments must be valid 
assembler source operands, and they must specify the information 
described in the RCVDS macro. This macro also generates an EMT 377 
using the ERR error service address as described in the DIRS macro. 


-MACRO RCVDSS TN,BA,ERR 
»-MCALL MOVS ,DIRS, RFAS 
MOVS BA 

RFA$ TN 

MOV (PC)+,-(SP) 

~-BYTE 75.,4 

DIRS ,ERR 

-ENDM RCVDSS 


C.2.88 RCVDS Macro 
The RCVD$ macro generates a DPB for the RECEIVE DATA directive. 
Macro call: RCVDS$ TASK,BUFADR 


Description: This macro generates a DPB for the RECEIVE DATA 
directive. The arguments are assumed to have the following meanings: 


TASK=Sender task name, 
BUFADR=Address of fifteen word buffer, 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 


R.VDTN-(length 4 bytes) Task name, 
R.VDBA-(2) Buffer address. 


If RCVDS is invoked with the S$$SGLB symbol defined, RCVDS does not 
generate the DPB and it globally defines the symbolic offsets. 


MACRO EXPANSIONS 


»-MACRO RCVDS TN,BA~ 
-MCALL OFFS, R50S 
-IF NDF SSSGLB 
-BYTE 75.,4 

R50$ TN 

-WORD BA 

~ENDC 

-IF NDF R.VDTN 
-NLIST 

.IRP X,<,<R.VDTN,4>,<R.VDBA,2>> 
OFFS X 

-ENDM 

-LIST 

~ENDC 

-ENDM RCVDS 


C.2.89 RCVXSC Macro 


The RCVXSC macro generates a DPB for the RECEIVE DATA OR EXIT 
directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 


Macro call: RCVXSC TASK,BUFADR,PSCT,ERR 


Description: This macro generates a DPB for the RECEIVE DATA OR EXIT 
DIRECTIVE in the program section named SDPBSS. The RCVXS macro 
describes the DPB parameters. This macro then generates an EMT 377 in 
the program section named in PSCT. The ERR error service address is 
described in the DIRS macro. The RCVXS macro controls the generation 
of symbolic offsets. 


-MACRO RCVXSC TN,BA,CS,ERR 

.MCALL RCVXS$ ,DIRS 

-IF NDF S$SSSGLB 

-PSECT SDPBSS$ 
$$$=., 

-IFTF 

RCVXS$ TN,BA 

.IFT 

-PSECT CS 

DIRS #$$$,ERR 

-ENDC 

»-ENDM RCVXSC 


C.2.90 RCVXSS Macro 


The RCVX$S macro generates the code to push a DPB for the RECEIVE DATA 
OR EXIT directive on the stack followed by an EMT 377. 


Macro call: RCVX$S TSKNAMADR,BUFADR,ERR 


Description: This macro generates the code to push a DPB for the 
RECEIVE DATA OR EXIT directive on the stack. The DPB arguments must 
be valid assembler source operands, and they must specify the 
information described in the RCVX$ macro. This macro also generates 
an EMT 377 using the ERR error service address as defined in the DIRS 
macro. 


-MACRO RCVX$S TN,BA,ERR 
~MCALL MOVS,DIRS, RFAS 


MACRO EXPANSIONS 


MOVS BA 

RFAS TN 

MOV (PC)+,-(SP) 
~-BYTE 77.,4 
DIRS ,ERR 
~ENDM RCVXSS 


C.2.91 RCVX$ Macro 


The RCVX$ macro generates a DPB for the RECEIVE DATA OR EXIT 
directive. 


Macro call: RCVXS TASK,BUFADR 


Description: This macro generates a DPB for the RECEIVE DATA OR EXIT 
directive. The arguments are assumed to have the following meanings: 


TASK=Sender task name, 
BUFADR=Address of fifteen word buffer. 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 


R.VXTN-(length 4 bytes) Task name, 
R.VXBA-(2) Buffer address. 


If RCVX$ is invoked with the $$S$GLB symbol defined, RCVXS does not 
generate the DPB and it globally defines the symbolic offsets. 


-MACRO RCVX$ TN,BA 
-MCALL OFFS, R50$ 
-IF NDF $SSSGLB 
~-BYTE 77.,4 

R50$ TN 

»-WORD BA 

- ENDC 

-IF NDF R.VXTN 
-NLIST 

-IRP X,<,<R.VXIN,4>,<R.VXBA,2>> 
OFFS X 

-ENDM 

-LIST 

»ENDC 

-ENDM RCVX$ 


C.2.92 RDAFSC Macro 


The RDAFSC macro generates a DPB for the READ ALL FLAGS directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 


Macro call: RDAFSC BUFADR,PSCT,ERR 


Description: This macro generates a DPB for the READ ALL FLAGS 
directive in the program section named SDPBS$. The DPB parameters are 
described in the RDAF$ macro. This macro then generates an EMT 377 in 
the program section named in PSCT. The DIRS macro describes the ERR 
error service address. The RDAF$S macro controls symbolic address 
generation. 
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»-MACRO RDAFSC BA,CS,ERR 

-MCALL RDAFS ,DIRS 

-IF NDF $SSGLB 

~PSECT SDPBSS 
$$$=, 

~IFTF 

RDAFS BA 

.IFT 

-PSECT CS 

DIRS #$55,ERR 

~ENDC 

-ENDM RDAFSC 


C.2.93 RDAFSS Macro 


The RDAFSS macro generates the code to push a DPB for the READ ALL 
FLAGS directive on the stack followed by an EMT 377. 


Macro call: RDAFSS BUFADR,ERR 


Description: This macro generates the code to push a DPB for the READ 
ALL FLAGS directive on the stack. The DPB arguments must be valid 
assembler source operands and must specify the information described 
in the RDAFS macro. RDAFSS also generates an EMT 377, using the ERR 
error service address, as described in the DIRS macro. 


.MACRO RDAFSS BA,ERR 
.MCALL MOVS ,DIRS 
MOVS BA 

MOV (PC)+,-(SP) 
-BYTE 39.,2 

DIRS ,ERR 

-ENDM RDAFSS 


C.2.94 RDAFS Macro 
The RDAFS macro generates a DPB for the READ ALL FLAGS directive. 
Macro call: RDAFS BUFADR 


Description: This macro generates a DPB for the READ ALL FLAGS 
directive. The argument is assumed to have the following meaning: 


BUFADR=Address of four word buffer. 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element: 


R.DABA-(length 2 bytes) Buffer address. 


If the macro is invoked with the $$$GLB symbol defined, RDAFS does not 
generate the DPB and it globally defines the symbolic offset. 


»-MACRO RDAFS BA 
-MCALL OFFS 

-IF NDF $$$GLB 
»BYTE 39.42 
-WORD BA 

»ENDC 

-IF NDF R.DABA 
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-NLIST 

OFFS 

OFFS R.DABA,2. 
.LIST 

»ENDC 

~ENDM RDAFS 


C.2.95 RFAS Macro 


RFAS is an internal macro that pushes two words on the stack in 
reverse order from the specified double-word. 


Macro call: RFAS ADR 


Description: RFAS generates the code to push two words on the stack 
in reverse order from the double word with its address specified by 
the source operand's ADR. 


-MACRO RFAS ADR 
-IF NB <ADR> 
-NLIST 

-NTYPE $$$T2,ADR 
~LIST 

~IF LT $$$T2-6 
MOV 2(ADR) ,-(SP) 
MOV (ADR) ,-(SP) 
~IFF 

MOV ADR,-(SP) 
MOV @(SP) ,-(SP) 
ADD #2,2(SP) 

MOV @2(SP) ,2(SP) 
-ENDC 

.IFF 

CLR ~(SP) 

CLR -(SP) 

.ENDC 

-ENDM RFAS 


C.2.96 RQSTSC Macro 


The RQSTSC macro generates a DPB for the REQUEST directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 


Macro call: RQSTSC TASK,PART,PRI ,UICGC,UICPC,PSCT,ERR 


Description: This macro generates a DPB for the REQUEST directive in 
the S$DPBS$ program’ section. The RQSTS$ macro describes the DPB 
parameters. RQSTSC then generates an EMT 377 in the program section 
named in PSCT. The DIR$ macro describes the ERR error service 
address. The RQSTS macro controls symbolic address generation. 


Note: Read the notice concerning ignored arguments in the RQSTS$ macro 
below. 


-MACRO RQSTSC TN,PN,PR,GC,P,CS,ERR 
-MCALL RQSTS ,DIRS 
-IF NDF $SSGLB 
»-PSECT SDPBS$ 
$$S=, 
-IFTF 


MACRO EXPANSIONS 


RQST$ TN,PN,PR,GC,P 
IFT 

-PSECT CS 

DIRS #$$$,ERR 

- ENDC 

- ENDM 


C.2.97 RQSTSS Macro 


The RQSTSS macro generates the code to push a DPB for the REQUEST 
directive on the stack followed by an EMT 377. 


Macro call: RQST$S TSKNAMADR,PRTNAMADR,PRI ,UICGC,UICPC,ERR 


Description: RQSTSS generates the code to push a DPB for the REQUEST 
directive on the stack. The DPB arguments must be valid assembler 
source operands and must specify the information described in the 
RQSTS macro. RQSTSS also generates an EMT 377 using the ERR error 
service address described in DIRS. 


Note: Read the notice concerning ignored arguments in the RQSTS macro 
below. 


-MACRO RQSTSS TN,PN,PR,GC,P,ERR 
-MCALL MVBS ,RFAS ,DIR$ 

MVBS P,GC 

CLR -(SP) 

RFAS 

RFAS TN 

MOV (PC) +,-(SP) 

-BYTE 11.,7 

DIRS ,ERR 

-ENDM ROSTSS 


C.2.98 RQSTS Macro 
The RQST$ macro generates a DPB for the REQUEST directive. 
Macro call: RQSTS TASK,PART,PRI,UIGC,UICPC 


Description: This macro generates a DPB for the REQUEST directive. 
The arguments are assumed to have the following meanings: 


TASK=Task name, 
PART=Partition name, 
PRI=Priority, 

UICGC=UIC group code, 
UICPC=UIC programmer code. 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 


R.QSTN-(length 4 bytes) Task name, 
R.QSPN-(4) Partition name, 
R.QSPR~-(2) Priority, 

R.QSGC-(1) UIC Group, 

R.QSPC-(1) UIC Programmer. 


MACRO EXPANSIONS 


If RQSTS is invoked with the $S$GLB symbol defined, RQSTS does not 
generate the DPB and it globally defines the symbolic offsets. 


Note: RQOSTS$ requires the arguments PART and PRI to maintain 
compatibility with RSX-11D. Despite the fact that they must be 
specified, RQSTS ignores them. 


-MACRO RQOSTS TN,PN,PE,GC,P 
-MCALL R50S ,OFFS$ 

-IF NDF $$SGLB 

-BYTE 11.,7 

R50$ TN 

-WORD 0,0 

-BYTE P,GC 

-ENDC 

.IF NDF R.QSTN 

-NLIST 

-IRP X,<,<R.QSTN,4>,<R.QSPN,4>,<R.QSPR,2>,<R.QSPC,1>,<R.QSGC,1>> 
OFFS X 

.ENDM 

.LIST 

.ENDC 

.ENDM ROSTS 


C.2.99 RSUMSC Macro 


The RSUMSC macro generates a DPB for the RESUME directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 


Macro call: RSUMSC TASK,PSCT,ERR 


Description: This macro generates a DPB for the RESUME directive in 
the S$DPBS$ program section. The RSUMS macro describes the DPB 
parameters. This macro then generates an EMT 377 in the program 
section named in PSCT. The ERR error service address is described in 


the DIR$ macro. The RSUMS$ macro controls generation of symbolic 
offsets. 


-MACRO RSUMSC TN,CS,ERR 
»~MCALL RSUMS ,DIRS 

-IF NDF $SSGLB 

»-PSECT SDPBS$ 


S$$=. 
~IFTF 
RSUMS TN 
IFT 
-PSECT CS 
DIRS #$$$,ERR 
. ENDC 


-ENDM RSUMSC 


C.2.100 RSUMSS Macro 


The RSUMSS macro generates the code to push a DPB for the RESUME 
directive on the stack and the code for an EMT 377. 


Macro call: RSUMSS TSKNAMADR,ERR 


MACRO EXPANSIONS 


Description: This macro generates the code to push a DPB for the 
RESUME directive on the stack. The DPB arguments must be valid 
assembler source operands, and they must specify the information 
described in the RSUMS$ macro. This macro also generates an EMT 377 
using the ERR error service address as described in the DIR$ macro. 


»-MACRO RSUMSS TN,ERR 
-MCALL RFA$,DIRS 
RFAS TN 

MOV (PC)+,-(SP) 
»-BYTE 47.,3 

DIRS ,ERR 

-ENDM RSUMSS 


C.2.101 RSUMS Macro 
The RSUMS macro generates a DPB for the RESUME directive. 
Macro call: RSUMS TASK 


Description: This macro generates a DPB for the RESUME directive. 
The argument is assumed to have the following meaning: 


TASK=Task name. 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element: 


R.SUTN-(length 4 bytes) Task name. 


If RSUM$ is invoked with the $$S$GLB symbol defined, RSUM$ does not 
generate the DPB and it globally defines the symbolic offset. 


-MACRO RSUMS TN 
-MCALL R50$,0FFS 
-IF NDF SS$SGLB 
-BYTE 47.,3 
R50S TN 

»ENDC 

-IF NDF R.SUTN 
»NLIST 

OFFS 

OFFS R.SUTN,4 
-LIST 

~ENDC 

-ENDM RSUMS 


C.2.102 RONSC Macro 


RUNSC generates a DPB for the RUN directive in a separate PSECT 
followed by an EMT 377 in the user specified PSECT. 


Macro call: RUNSC TSK,PRT,PRI,UGC,UPC,SMG,SNT,RMG,RNT,PSCT,ERR 


Description: RUNSC generates a DPB for the RUN directive in the 
SDPB$$ program section. RUNS describes the DPB parameters. RUNSC 
then generates an EMT 377 in the program section named in PSCT. DIRS 
describes the ERR error service address. The RUNS macro controls 
symbolic address generation. 


MACRO EXPANSIONS 


Note: Read the discussion notice concerning ignored arguments in the 
RUNS macro below. 


«MACRO RUNSC TN,PN,PR,UG,UP,SM,SU,RM,RU,CS,ERR 
-MCALL RUNS ,DIRS 

~IF NDF SSSGLB 

-PSECT SDPBS$ 


$$$=. 
-IFTF 
RUN$ TN,PN,PR,UG,UP,SM,SU ,RM,RU 
-IFT 
«PSECT CS 
DIRS #$$$,ERR 
. ENDC 
-ENDM RUNSC 


C.2.103 RONSS Macro 


RUNSS generates the code toe push a DPB for the RUN directive on the 
stack and generates an EMT 377. 


Macro call: RUNSS TNAMADR,PNAMADR,PRI,UGC,UPC,SMG,SNT,RMG,RNT,ERR 


Description: RUNSS generates the code to push a DPB for the RUN 
directive on the stack and generates an EMT 377 using the ERR error 
service address described in DIRS. DPB: arguments must be valid 
assembler source operands and must specify the information described 
in the RUNS macro. 


Note: Read the discussion notice concerning ignored arguments in the 
RUNS macro below. 


.MACRO RUNSS TN,PN,PR,UG,UP,SM,SU,RM,RU,ERR 
-MCALL RVPS ,MVBS,RFAS ,DIRS 
RVP$ SM,SU,RM,RU 

MVBS UP,UG 

CLR -(SP) 

RFAS 

RFAS TN 

MOV (PC)+,-(SP) 

-BYTE 17.,11. 

DIRS ,ERR 

-ENDM RUNSS 


C.2.104 RUNS Macro 

The RUNS macro generates a DPB for the RUN directive. 

Macro call: RUNS TSK,PRT,PRI,UGC,UPC,SMG,SNT,RMG,RNT 
Description: The arguments must have the following meanings: 


TSK=Task name, 

PRT=Partition name, 

PRI=Priority, 

UGC=UIC group code, 

UPC=UIC programmer code, 
SMG=Schedule delta magnitude, 
SNT=Schedule delta unit, 
RMG=Re~schedule interval magnitude, 
RNT=Re-schedule interval unit. 
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The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 


R.UNTN-(length 4 bytes) Task name, 
R.UNPN-(4) Partition name, 
R.UNPR-(2) Priority, 

R.UNGC-(1) UIC group, 

R.UNPC-(1) UIC programmer, 
R.UNSM-(2) Schedule magnitude, 
R.UNSU-(2) Schedule unit, 
R.UNRM-(2) Re~schedule magnitude, 
R.UNRU-(2) Re-schedule unit. 


If RUNS is invoked with the $S$$GLB symbol defined, RUNS does not 
generate the DPB and RUNS globally defines the symbolic offsets. 


Note: RUNS requires the PRT and PRI arguments to maintain 
compatibility with RSX-11D. Despite the fact that they must be 
specified, RUNS ignores them. 


»MACRO RUNS TN,PN,PR,GC,P,SM,SU,RM,RU 
»MCALL R50$ ,OFFS 
-IF NDF $SSGLB 
-BYTE 17.,11. 
R50$ TN 
-WORD 0,0 
-WORD 0 
-BYTE P,GC 
-WORD SM 
-WORD SU 
-WORD RM 
«WORD RU 
»ENDC 
-IF NDF R.UNTN 
-NLIST 
-IRP X,<,<R.UNTN,4>,<R.UNPN,4>,<R.UNPR,2>,<R.UNPC,1>,<R.UNGC,1>> 
OFFS X 
.ENDM 
-IRP X,<<R.UNSM,2>,<R.UNSU,2>,<R.UNRM,2>,<R.UNRU,2>> 
OFFS X 
»ENDM 
-LIST 
-ENDC 
-ENDM RUNS 


C.2.105 RVPS$ Macro 


RVP$ is an internal macro that places the parameters passed as an 
argument list into the stack in reverse order. 


Macro call: RVPS Al,A2,...,A10 


Description: RVP$ pushes the elements of the argument list on _ the 
stack in reverse order. RVPS$ assumes all elements to be full-word. 
The list is limited to a maximum of ten elements. 


-MACRO RVPS PO,P1,P2,P3,P4,P5,P6,P7,P8,P9 
-MCALL MOVS 

»NLIST 

»NARG SSSARG 

»LIST 


MACRO EXPANSIONS 


-IIF GT SSSARG~9., MOVS <P9> 
-IIF GT SSSARG-8., MOVS <P8> 
-IIF GT S$SSARG-7, MOVS <P7> 
-IIF GT SSSARG-6, MOVS <P6> 
-IIF GT $SSARG-5, MOVS <P5> 
-IIF GT $SSARG-4, MOVS <P4> 
-IIF GT SSSARG-3, MOVS <P3> 
-IIF GT $SSARG-2, MOVS <P2> 
-IIF GT S$SSARG-1, MOVS <P1> 
-IIF GT S$SSARG, MOVS <PO> 
-ENDM RVPS 


C.2.106 SDATSC Macro 


The SDATSC macro generates a DPB for the SEND DATA directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 


Macro call: SDATSC TASK,BUFADR,EFN,PSCT,ERR 


Description: SDATSC generates a DPB for the SEND DATA directive in 
the SDPBS$ program section and generates an EMT 377 in the program 
section named in PSCT. SDATS describes the DPB parameters and 
controls symbolic address generation. DIRS describes the ERR error 
service address. 


-MACRO SDATSC TN,BA,EFN,CS,ERR 

-MCALL SDATS ,DIRS 

-IF NDF S$SSGLB 

-PSECT SDPBSS$ 
$$$=, 

~IFTF 

SDATS TN,BA,EFN 

IFT 

-PSECT CS 

DIRS #$$$,ERR 

.ENDC 

-ENDM SDATSC 


C.2.107 SDATSS Macro 


SDATSS generates the code to push a DPB for the SEND DATA directive on 
the stack and generates an EMT 377. 


Macro call: SDATSS TSKNAMADR,BUFADR,EFN,ERR 


Description: SDATSS generates the code to push a DPB for the SEND 
DATA directive on the stack and generates an EMT 377 using the ERR 
error service address described in DIR$. The DPB arguments must be 
valid assembler source operands and they must specify the information 
described in the SDATS macro. 


-MACRO SDATSS TN,BA,EFN,ERR 
-MCALL MOVS ,RFAS ,DIRS$ 

MOV$ EFN 

MOVS BA 

RFA$ TN 

MOV (PC)+,-(SP) 

-BYTE 71.,5 

DIRS ,ERR 

-ENDM SDATSS 


MACRO EXPANSIONS 


C.2.108 SDATS Macro 
The SDATS macro generates a DPB for the SEND DATA directive. 
Macro call: SDATS TASK,BUFADR,EFN 


Description: This macro generates a DPB for the SEND DATA - directive. 
The arguments are assumed to have the following meanings: 


TASK=Receiver task name, 
BUFADR=Address of thirteen word data buffer, 
EFN=Event flag number. 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 


S.DATN-(length 4 bytes) Task name, 
S.DABA-(2) Buffer address, 
S.DAEF-(2) Event flag number. 


If SDATS is invoked with the $$SGLB symbol defined, SDAT$ does not 
generate the DPB and it globally defines the symbolic offsets. 


-MACRO SDATS TN,BA,EFN 
-MCALL R50$ ,OFFS 

-IF NDF SSSGLB 

-BYTE 71.,5 

R50S TN 

-WORD BA 

-WORD EFN 

-ENDC 

-IF NDF S.DATN 

-NLIST 

.IRP X,<,<S.DATN,4>,<S.DABA,2>,<S.DAEF,2>> 
OFFS X 

-ENDM 

-LIST 

»ENDC 

-ENDM SDATS 


C.2.109 SETFSC Macro 


The SETFSC macro generates a DPB for the SET EVENT FLAG directive ina 
separate PSECT followed by an EMT 377 in the user specified PSECT. 


Macro call: SETFSC EFN,PSCT,ERR 


Description: This macro generates a DPB for the SET EVENT FLAG 
directive in the program section named $DPB$$. The SETF$S macro 
describes the DPB parameters. The SETFSC macro then generates an EMT 
377 in the program section named in PSCT. The DIRS macro describes 
the ERR error service address. The SETFS macro controls symbolic 
offset generation. 


»-MACRO SETFSC EFN,CS,ERR 
-MCALL SETFS ,DIRS 
-IF NDF S$SSGLB 
-PSECT SDPBSS 
$$$=., 
~IFTF 
SETFS EFN 
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~IFT 
-PSECT CS 
DIRS #$$$,ERR 
» ENDC 

~ENDM SETFSC 


C.2.110 SETFSS Macro 


SETF$S pushes a DPB for the SET EVENT FLAG directive on the stack and 
generates an EMT 377. 


Macro call: SETFSS EFN,ERR 


Description: SETSF pushes a DPB for the SET EVENT FLAG directive on 
the stack. DPB arguments must be valid assembler operands and specify 
the information described in the SETFS macro. SETSF also generates an 
EMT 377 using the ERR error service address that DIRS describes. 


~MACRO SETFSS EFN,ERR 
-MCALL MOVS ,DIR$ 

MOVS EFN 

MOV (PC)+,-(SP) 

~BYTE 33.,2 

DIRS ,ERR 

-ENDM SETFSS 


C.2.111 SETFS Macro 


The SETFS$ macro generates a DPB for the SET EVENT FLAG directive. 


Macro call: SETFS$ EFN 


Description: This macro generates a DPB for the SET EVENT FLAG 
directive. The argument is assumed to have the following meaning: 


EFN=Event flag number. 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element: 


S.ETEF-(length 2 bytes) Event flag. 


If SETFS is invoked with the S$$$GLB symbol defined, SETFS does not 
generate the DPB and it globally defines the symbolic offset. 


«MACRO SETFS EFN 
«MCALL OFFS 
-IF NDF $S$S$GLB 
-BYTE 33.,2 
~WORD EFN 

- ENDC 

-IF NDF S.ETEF 
eNLIST 

OFFS 

OFFS S.ETEF,2 
»LIST 

»ENDC 

-ENDM SETFS$ 


MACRO EXPANSIONS 


The SFPASC macro generates a DPB for the SPECIFY FLOATING POINT 
EXCEPTION AST directive in a separate PSECT followed py an EMT 377 in 
the user specified PSECT. 


Macro call: SFPASC AST,PSCT,ERR 


Description: SFPASC generates a DPB for the SPECIFY FLOATING POINT 
EXCEPTION AST directive in the SDPBS$ program. section. SFPAS 
describes the DPB parameters. SFPASC then generates an EMT 377 in the 
program section named in PSCT. DIRS describes the ERR error service 
address. The SFPAS macro controls symbolic offset generation. 


-MACRO SFPASC AST,CS,ERR 
.MCALL SFPAS ,DIRS 

-IF NDF $SSGLB 

»PSECT $DPBS$$ 


SFPAS AST 
~IFT 

-PSECT CS 
DIRS #$5$,ERR 
- ENDC 

-ENDM SFPASC 


C.2.113 SFPASS Macro 


SFPASS generates the code to push a DPB for the SPECIFY FLOATING POINT 
EXCEPTION AST directive on the stack and generates an EMT 377. 


Macro call: SFPASS AST,ERR 


Description: This macro generates the code to push a DPB for the 
SPECIFY FLOATING POINT EXCEPTION AST directive on the stack. The DPB 
arguments must be valid assembler source operands, and they must 
specify the information described in the SFPAS macro. The SFPASS 
Macro also generates an EMT 377 using the ERR error service address as 
described in the DIRS macro. 


-MACRO SFPASS AST,ERR 
-MCALL MOVS ,DIR$ 

MOVS AST 

MOV (PC)+,~-(SP) 

-BYTE 111.,2 

DIR$ ,ERR 

~-ENDM SFPASS 


C.2.114 SFPAS Macro 


SFPAS generates a DPB for the SPECIFY FLOATING POINT EXCEPTION AST 
directive. 


Macro call: SFPAS AST 
Description: The argument must have the following meaning: 


AST=AST Service entry address. 


MACRO EXPANSIONS 


The following symbol is locally defined with its assigned values equal 
to the byte offset from the start of the DPB to the DPB element: 


S.FPAE-(length 2 bytes) AST Entry address. 


If SFPAS is invoked with the $SSGLB symbol defined, SFPAS does not 
generate the DPB and it globally defines the symbolic offsets. 


-MACRO SFPAS AST 
»MCALL OFFS 
-IF NDF $SS$GLB 
-BYTE 111.,2 
-WORD AST 
»ENDC 

-IF NDF S.FPAE 
»NLIST 

OFFS 

OFFS S.FPAE,2 
~LIST 

- ENDC 

~-ENDM SFPAS 


C.2.115 SPNDSC Macro 


SPNDSC generates a DPB for the SUSPEND directive in a separate PSECT 
followed by an EMT 377 in the user specified PSECT. 


Macro call: SPNDSC PSCT,ERR 


Description: SPNDSC generates a DPB for the SUSPEND directive in the 
SDPBS$ program section followed by an EMT 377 in the original program 
section named PSCT. DIRS describes the ERR error service address. 


«MACRO SPNDSC PSCT,ERR 

-MCALL SPNDS ,DIRS 

-IF NDF $$SGLB 

-PSECT $DPBS$ 
$$S=, 

~IFTF 

SPNDS 

IFT 

-PSECT PSCT 

DIRS #$$$,ERR 

-ENDC 

.ENDM SPNDSC 


C.2.116 SPNDSS Macro 


The SPND$SS macro generates the code to push a DPB for the SUSPEND 
directive on the stack and generates an EMT 377. 


Macro call: SPNDSS ERR 


Description: This macro generates the code to push a one-word DPB for 
the SUSPEND directive on the stack. Then it generates an EMT 377 
using the error service address as described in the DIRS macro. 


-MACRO SPNDSS ERR 


~MCALL DIRS 
MOV (PC)+,-(SP) 
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~-BYTE 45.,1 
DIRS ,ERR 
-ENDM SPNDSS 


C.2.117 SPND$ Macro 
The SPNDS macro generates a DPB for the SUSPEND directive. 
Macro call: SPNDS 


Description: This macro generates a DPB for the SUSPEND directive. 
There are no arguments. 


«MACRO SPND$ 
-IF NDF $$$GLB 
~BYTE 45.,1 
-ENDC 

-ENDM SPNDS 


C.2.118 SPRASC Macro 


The SPARSC macro generates a DPB for the SPECIFY POWER RECOVERY AST 
directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 


Macro call: SPRASC AST,PSCT,ERR 


Description: This macro generates a DPB for the SPECIFY POWER 
RECOVERY AST directive in the SDPBS$$ program section. The SPRAS macro 
describes the DPB parameters. The SPRASC macro then generates an EMT 
377 in the program section named in PSCT. The DIRS macro describes 
the ERR error service address. The SPRAS macro controls the 
generation of symbolic offsets. 


.-MACRO SPRASC AST,CS,ERR 
.MCALL SPRAS ,DIRS$ 
-IF NDF SSSGLB 
-PSECT SDPBS$$ 
$$$=, 


-PSECT CS 
DIRS #$$$,ERR 
.ENDC 

-ENDM SPRASC 


C.2.119 SPRASS Macro 


The SPRASS macro generates the code to push a DPB for the SPECIFY 
POWER RECOVERY AST directive on the stack and generates an EMT 377. 


Macro call: SPRASS AST,ERR 


Description: This macro generates the code to push a DPB for. the 
SPECIFY POWER RECOVERY AST directive on the stack. The DPB arguments 
must be valid assembler source operands, and they must specify the 
information described in the SPRAS macro. The SPRASS macro also 


MACRO EXPANSIONS 


generates an EMT 377 using the ERR error service address as described 
in the DIRS macro. 


-MACRO SPRASS AST,ERR 
»MCALL MOVS ,DIRS 

MOVS AST 

MOV (PC)+,-(SP) 

~-BYTE 109.,2 

DIRS ,ERR 

-ENDM SPRASS 


C.2.120 SPRAS$ Macro 


The SPRAS macro generates a DPB for the SPECIFY POWER RECOVERY AST 
directive. 


Macro call: SPRAS AST 


Description: This macro generates a DPB for the SPECIFY POWER 
RECOVERY AST directive. The argument is assumed to have the following 
meaning: 


AST=AST Service entry address. 


The following symbol is locally defined with is assigned a value equal 
to the byte offset from the start of the DPB to the DPB element: 


S.PRAE-~(length 2 bytes) AST entry address. 


If SPRAS is invoked with the SSSGLB symbol defined, SPRAS does not 
generate the DPB and it globally defines the symbolic offset. 


-MACRO SPRAS AST 
-MCALL OFFS 
-IF NDF S$S$SGLB 
-BYTE 109.,2 
-WORD AST 

- ENDC 

-IF NDF S.PRAE 
-NLIST 

OFFS 

OFFS S.PRAE,2 
~LIST 

»ENDC 

-ENDM SPRAS 


C.2.121 SRDASC Macro 


The SRDASC macro generates a DPB for the SPECIFY RECEIVE DATA AST 
directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 


Macro call: SRDASC AST,PSCT,ERR 


Description: This macro generates a DPB for the SPECIFY RECEIVE DATA 
AST directive in the $DPBS$ program section. The SRDAS macro 
describes the DPB parameters. This macro then generates an EMT 377 in 
the program section named in PSCT. The DIRS macro describes the ERR 
error service address. The SRDAS macro controls symbolic offset 
generation. 


MACRO EXPANSIONS 


«MACRO SRDASC AST,CS,ERR 

-MCALL SRDAS ,DIRS 

~IF NDF SSSGLB 

»PSECT SDPBSS 
$$S$=, 

~IFTF 

SRDAS AST 

IFT 

-PSECT CS 

DIRS #$$$,ERR 

~ENDC 

-ENDM SRDASC 


C.2.122 SRDASS Macro 


SRDASS macro pushes a DPB for the SPECIFY RECEIVE DATA AST directive 
on the stack and generates an EMT 377. 


Macro call: SRDASS AST,ERR 


Description: This macro generates the code to push a DPB for the 
SPECIFY RECEIVE DATA AST directive on the stack. The DPB arguments 
must be valid assembler source operands, and they must specify the 
information described in the SRDAS macro. The SRDASS macro also 
generates an EMT 377 using the ERR error service address as described 
in the DIRS macro. . 


-MACRO SRDASS AST,ERR 
-MCALL MOVS ,DIR$ 

MOV$ AST 

MOV (PC) +,-(SP) 

~BYTE 107.,2 

DIRS ,ERR 

-ENDM SRDASS 


C.2.123 SRDAS$ Macro 
SRDAS generates a DPB for the SPECIFY RECEIVE DATA AST directive. 
Macro call: SRDAS AST 


Description: This macro generates a DPB for the SPECIFY RECEIVE DATA 
AST directive. The argument is assumed to have the following meaning: 


AST=AST service entry address. 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element: 


S.RDAE-(length 2 bytes) AST entry address. 


If SRDAS is invoked with the S$SS$GLB symbol defined, SRDAS does not 
generate the DPB and it globally defines the symbolic offset. 


»MACRO SRDAS AST 
-MCALL OFFS 

-IF NDF $S$SGLB 
-BYTE 107.,2 
-WORD AST 

~ENDC 
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.IF NDF S.RDAE 
-NLIST 

OFFS 

OFFS S.RDAE,2 
.LIST 

»ENDC 

-ENDM SRDAS 


C.2.124 SVDBSC Macro 


SVDBSC generates a DPB for the SPECIFY SST VECTOR TABLE FOR DEBUGGING 


AID directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 


Macro call: SVDBSC ADR,LEN,PSCT,ERR 


Description: SVDBSC generates a DPB for the SPECIFY SST VECTOR TABLE 
FOR DEBUGGING AID directive in the S$DPBS$S program section and 
generates an EMT 377 in the program section named in PSCT. SVDBS$ 
describes the DPB parameters and controls symbolic address generation. 
DIRS describes the ERR error service address. 


-MACRO SVDBSC AD,LN,CS,ERR 
-MCALL SVDBS$ ,DIRS 

-IF NDF SSSGLB 

»-PSECT SDPBS$ 


$S$=. 
-IFTF 
SVDB$ AD,LN 
-IFT 
-PSECT CS 
DIRS #$$$,ERR 
. ENDC 


~-ENDM SVDBSC 


C.2.125 SVDBSS Macro 


The SVDBSS macro generates the code to push a DPB for the SPECIFY SST 
VECTOR TABLE FOR DEBUGGING AID directive on the stack and generates an 
EMT 377. : 


Macro call: SVDBSS ADR,LEN,ERR 


Description: SRDASS macro pushes a DPB for the SPECIFY SST VECTOR 
TABLE FOR DEBUGGING AID directive on the stack. DPB arguments must be 
valid assembler operands and must specify the information described by 
SVDBS. SVDB$S also generates an EMT 377 using the ERR error service 
address described by DIRS. 


-MACRO SVDBSS AD,LN,ERR 
»-MCALL MOVS ,DIRS 

MOVS LN 

MOVS AD 

-BYTE 103.,3 

DIRS ,ERR 

.ENDM SVDBSS 
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C.2.126 SVDBS Macro 


The SVDBS macro generates a DPB for the SPECIFY SST VECTOR TABLE FOR 
DEBUGGING AID directive. 


Macro call: SVDBS ADR,LEN 


Description: This macro generates a DPB for the SPECIFY SST VECTOR 
TABLE FOR DEBUGGING AID directive. The araquments are assumed to have 
the following meanings: 


ADR=Address of SST vector table, 
LEN=Length of (number of entries in) table. 


The following symbols are locally defined with their assigned values 
egual to the byte offset from the start of the DPB to the respective 
DPB elements: 


S.VDTA-(length 2 bytes) Table address, 
S.VDTL-(2) Table length. 


If SVDBS is invoked with the $$$GLB symbol defined, SVDB$ does not 
generate the DPB and it globally defines the symbolic offsets. 


-MACRO SVDBS A,L 
»MCALL OFFS 

-IF NDF S$S$S$GLB 
-BYTE 103.,3 
-WORD A 

-WORD L 

» ENDC 

-IF NDF S.VDTA 
.NLIST 

-IRP X,<,<S.VDTA,2>,<S.VDTL,2>> 
OFFS X 

.ENDM 

-LIST 

~ENDC 

-ENDM SVDBS$ 


C.2.127 SVTKSC Macro 


SVTKSC generates a DPB for the SPECIFY SST VECTOR TABLE FOR TASK 
directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 


Macro call: SVTKSC ADR,LEN,PSCT,ERR 


Description: SVTKSC generates a DPB for the SPECIFY SST VECTOR TABLE 
FOR TASK directive in the S$DPB$$ program section and generates an EMT 
377 in the program section named in PSCT. DIRS describes the ERR 
error service address. The SVTKS macro controls symbolic address 
generation and describes DPB parameters. 


»-MACRO SVTKSC ADR,LEN,CS,ERR 
-MCALL SVTKS ,DIRS 
-IF NDF $$SGLB 
»-PSECT SDPBS$ 
$$$=, 


SVTK$ ADR,LEN 
-IFT 


MACRO EXPANSIONS 


-PSECT CS 
DIRS #$$$,ERR 
. ENDC 

-ENDM SVTKSC 


C.2.128 SVTKSS Macro 


The SVTKSS macro generates the code to push a DPB for the SPECIFY SST 
VECTOR TABLE FOR TASK directive on the stack and generates an EMT 377. 


Macro call: SVTK$S ADR,LEN,ERR 


Description: This macro generates the code to push a DPB for the 
SPECIFY SST VECTOR TABLE FOR TASK directive on the stack. The DPB 
arguments must be valid assembler source operands, and they must 
specify the information described in the SVTKS macro. This macro also 
generates an EMT 377 using the ERR error service address as described 
in the DIRS macro. 


-MACRO SVTKSS ADR,LEN,ERR 
»MCALL MOVS ,DIRS 

MOVS LEN 

MOVS ADR 

MOV (PC) +,-(SP) 

-BYTE 105.,3 

DIRS ,ERR 

-ENDM SVTKSS 


C.2.129 SVTKS Macro 


The SVTKS macro generates a DPB for the SPECIFY SST VECTOR TABLE FOR 
TASK directive. 


Macro call: SVTKS ADR,LEN 


Description: This macro generates a DPB for the SPECIFY SST VECTOR 
TABLE FOR TASK directive. The arguments are assumed to have the 
following meanings: 


ADR=Address of SST vector table, 
LEN=Length of (number of entries in) table. 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 


S.VTTA-(length 2 bytes) Table address, 
S.VTTL-(2) Table length. 


If SVTKS is invoked with the $$SGLB symbol defined, SVTK$ does not 
generate the DPB and it globally defines the symbolic offsets. 


»MACRO SVTKS TA,TL 
»~MCALL OFFS 

-IF NDF S$S$$GLB 
»-BYTE 105.,3 

~WORD TA 

-WORD TL 

.ENDC 

.IF NDF S.VTTA 
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»NLIST 

.IRP X,<,<S.VTTA,2>,<S.VTTL,2>> 
OFFS X 

.ENDM 

.LIST 

»ENDC 

»ENDM SVTKS 


C.2.130 WSIGSC Macro 


The WSIGSC macro generates a DPB for the WAIT FOR SIGNIFICANT EVENT 
directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 


Macro call: WSIGSC PSCT,ERR 


Description: This macro generates a DPB for the WAIT FOR SIGNIFICANT 
EVENT directive in the $DPBS$ program section followed by an EMT 377 
in the user specified program section that is named PSCT. The DIRS 
Macro describes the ERR error service address. 


-MACRO WSIGSC PSCT,ERR 

-MCALL WSIGS$ ,DIRS 

-IF NDF SSSGLB 

»-PSECT SDPBSS 
$$$=. 

~IFTF 

WSIGS 

IFT 

-PSECT PSCT 

DIRS #$$$,ERR 

~ENDC 

~ENDM WSIGSC 


C.2.131 WSIGSS Macro 


The WSIGSS macro generates the code to push a DPB for the WAIT FOR 
SIGNIFICANT event directive on the stack and generates an EMT 377. 


Macro call: WSIGSS ERR 


Description: This macro generates the code to push a one-word DPB for 
the WAIT FOR SIGNIFICANT EVENT directive on the stack. Then it 
generates an EMT 377 using the ERR error service address as described 
in the DIRS$ macro. 


»MACRO WSIGS$S ERR 
-MCALL DIRS 

MOV (PC)+,-(SP) 
»-BYTE 49.,1 

DIRS ,ERR 

~-ENDM WSIGSS 


C.2.132 WSIGS Macro 


The WSIGS macro generates a DPB for the WAIT FOR SIGNIFICANT EVENT 
directive. 


MACRO EXPANSIONS 


Macro call: wWSIGS 


Description: This macro generates a DPB for the WAIT FOR SIGNIFICANT 
EVENT directive. There are no arguments. 


-MACRO WSIGS 
-IF NDF $$SGLB 
-BYTE 49.,1 
~ENDC 

-ENDM WSIGS 


C.2.133 WTLOSC Macro 


The WTLOSC Macro generates a DPB for the WAIT FOR LOGICAL OR OF EVENT 
FLAGS directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. ; 


Macro call: WTLOSC SET,MASK,PSCT,ERR 


Description: This macro generates a DPB for the WAIT FOR LOGICAL OR 
OF EVENT FLAGS directive in the SDPB$$ program section. The WTLOS 
macro describes the DPB parameters. The WTLOSC macro then generates 
an EMT 377 in the program section named in PSCT. The DIRS macro 
describes the ERR error service address. The WTLOS macro controls 
symbolic offset generation. 


Note: Read the discussion notice concerning ignored arguments in the 
WTLOS macro below. 


-MACRO WTLOSC SET,MASK,CS,ERR 
-MCALL WTLOS ,DIRS 

.IF NDF SSSGLB 

»PSECT SDPBSS$ 


$$$=. 
~IFTF 
WTLOS SET,<MASK> 
IFT 
.PSECT CS 
DIRS #$$$,ERR 
.ENDC 


~ENDM WTLOSC 


C.2.134 WYTLOSS Macro 


The WILO$S macro generates the code to push a DPB for the WAIT FOR 
LOGICAL OR OF EVENT FLAGS directive on the stack and generates an EMT 
ce a Ae 


Macro call: WTLOSS SET,MASK,ERR 


Description: This macro generates the code to push a DPB for the WAIT 
FOR LOGICAL OR OF EVENT FLAGS directive on the stack. The arguments 
are assumed to have the following meanings: 


SET=Desired set of event flags (0-4) 
MASK=Assembler source operand that yields the desired 
mask word 


The macro also generates an EMT 377, using the ERR error service 
address as described in the DIRS macro. 
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Note: Read the discussion notice concerning ignored arguments in the 
WTLOS macro below. 


»MACRO WTLOSS SET,MSK,ERR 
»-MCALL MOVS ,DIRS 
~-IF EQ SET-4 
»-ERROR SET ;Unsupported macro option; 
~IFF 
MOVS MSK 
-IF NE SET 
MOV #SET,- (SP) 
~IFF 
LR -(SP) 
~ENDC 
MOV (PC)+,-(SP) 
»-BYTE 43.,3 
» ENDC 
DIRS ,ERR 
~-ENDM WTLOSS 


C.2.135 WTLOS Macro 


The WILOS macro generates a DPB for the WAIT FOR LOGICAL OR OF EVENT 
FLAGS directive. 


Macro call: WTLOS SET,MASK 


Description: This macro generates a DPB for the WAIT FOR LOGICAL OR 
OF EVENT FLAGS directive. The arguments are assumed to have the 
following meanings: 


SET=Desired set of event flags (0-4), 
MASK=If£ set is 0, 1, 2, or 3, a 16-bit (16 flag) mask word; 
If set is 4, a list of four mask words (<M1,M2,M3,M4>). 


WTLOS does not define any symbolic offsets. WTLO$ does not generate 
any code if the $$GLB symbol is defined at the time WTLOS is invoked. 


Note: RSX-l11M does not support the specification of flags set number 
4. If flag set number 4 is specified it causes an error. 


-MACRO WTLOS SET,MASK 
-IF NDF S$SSGLB 
~IF EQ SET-4 


«ERROR SET ;Unsupported macro option 
~IFF 

~-BYTE 43.,3 

»~WORD SET 

-WORD MASK 

»ENDC 

»ENDC 


~-ENDM WTLOS 


C.2.136 WTSESC Macro 

The WTSESC macro generates a DPB for the WAIT FOR SINGLE EVENT FLAG 
directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 


Macro call: WTSESC EFN,PSCT,ERR 


MACRO EXPANSIONS 


Description: This macro generates a DPB for the WAIT FOR SINGLE EVENT 
FLAG directive in the $DPBSS section. The WTISES macro describes the 
DPB parameters. The WTSESC macro then generates an EMT 377 in the 
program section named in PSCT. The DIRS macro describes the ERR error 
service address. The WTSES macro controls symbolic address 
generation. 


»MACRO WTSESC EF,CS,ERR 

-MCALL WTSES ,DIRS 

-IF NDF $SSGLB 

-PSECT SDPBS$$ 
$$$=,. 

.IFTF 

WTSES EF 

~IFT 

»PSECT CS 

DIRS #$$$,ERR 

~ENDC 

~ENDM WTSESC 


C.2.137 WTSESS Macro 


The WISESS macro generates the code to push a DPB for the WAIT FOR 
SINGLE EVENT FLAG directive on the stack and generates an EMT 377. 


Macro call: WTSESS EFN,ERR 


Description: This macro generates the code to push a DPB for the WAIT 
FOR SINGLE EVENT FLAG directive on the stack. The DPB arguments must 
be valid assembler source operands, and they must specify the 
information described in the WISESS macro. This macro also generates 
an EMT 377, using the ERR error service address as described in the 
DIRS macro. 


-MACRO WTSESS EF,ERR 
.MCALL MOVS ,DIRS 
MOVS EF 

MOV (PC)+,-(SP) 
~-BYTE 41.,2 


DIRS ,ERR 
-ENDM WTSESS 


C.2.138 WYSES Macro 
WTSES generates a DPB for the WAIT FOR SINGLE EVENT FLAG directive. 
Macro call: WTSES EFN 


Description: WTSES generates a DPB for the WAIT FOR SINGLE EVENT FLAG 
directive. The argument must have the following meaning: 


EFN=Event flag number. 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element: 


W.TSEF-(length 2 bytes) Event flag number. 


If WTSES is invoked with the S$S$S$GLB symbol defined, WTSES does not 
generate the DPB and it globally defines the symbolic offset. 


MACRO EXPANSIONS 


«MACRO WTSES EFN 
-MCALL OFFS 
-IF NDF $SSGLB 
~BYTE 41.,2 
-WORD EFN 
»ENDC 

~IF NDF W.TSEF 
.NLIST 

OFFS 

OFFS W.TSEF,2 
.LIST 

. ENDC 

-ENDM WTISES 


C.3 EXECUTIVE MACRO EXPANSIONS 


The following coded instructions are expansions of macros that you may 
find in the Executive source listings of RSX-11M. 


(C.3.1 CALL Macro 


.MACRO CALL SUBR ARG 
.IF IDN <SINTSV>,<SUBR> 
JSR R5,SINTSV 

.IF DF LSS$SIl 

~WORD ARG 

.IFF 

~WORD “C<ARG>&PR7 

-ENDC 

~IFF 

.IF IDN <SSAVNR>,<SUBR> 
JSR R5,SSAVNR 

.IFF 

~IF IDN <SSWSTK> ,<SUBR> 
EMT 376 

-WORD ARG 

.IFF 

JSR PC,SUBR 

-ENDC 

.ENDC 

~ENDC 

.ENDM 


C.3.2 CALLR Macro 


CALLR is a call and return from subroutine macro. 


-MACRO CALLR SUBR 
JMP SUBR 
» ENDM 


MACRO EXPANSIONS 


C.3.3 CRASH Macro 
CRASH crashes the system. 


-MACRO CRASH 
IOT 
- ENDM 


C.3.4 DIRSV$ Macro 
DIRSV$ is the directive register save and set priority macro. 


«MACRO DIRSVS 
JSR R5,SDIRSV 
»ENDM 


C.3.5 DRSTS Macro 
DRSTS causes a trap to set directive status. 


»-MACRO DRSTS VALUE 
TRAP VALUE 
-ENDM 


C.3.6 GTUCB$ Macro 


GTUCBS generates code to load the UCB address into R5. It is called 
by INTSES and INTSV$ only. 


-MACRO GTUCBS UCBSV,NCTRLR 
-IF NB <UCBSV> 
-IF GT NCTRLR-1 
MOV UCBSV(R4) ,R5 
-IFF 

MOV UCBSV,R5 
-ENDC 

~IFF 

-IF GT NCTRLR-1 
MOV CNTBL(R4) ,R5 
-IFF 

MOV CNTBL,R5 

- ENDC 

- ENDC 

- ENDM 


C.3.7 INTLB Macro 
Generates an interrupt routine entry point label. 


-IF DF ESSDVC 
-MACRO INTLB NUM,NAM 
S'NAM'NUM'T:: 
-ENDM 
~ENDC 
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C.3.8 INTSES Macro 
This is the interrupt save generation macro for error logging devices. 


-MACRO INTSES DEV,PRI,NCTRLR,PSWSV,UCBSV, ?LAB 
~IF DF LSSDRV & LDS'DEV & MSSMGE 
S'DEV'INT:: 
-IF NDF ESSDVC 
-IF EQ NCTRLR-1 
CLR R4 
~ENDC 
~ENDC 
~IFF 
-IF NDF ESSDVC 
S'DEV'INT::INTSVS$ DEV,PRI,NCTRLR,PSWSV,UCBSV 
-IF EQ NCTRLR-1 
CLR R4 
~ENDC 
-MEXIT 
-IFF 
$$$=0 
.-REPT NCTRLR 
INTLB \$$S$,DEV 
JSR R5,SINTSE 
SCBLB \$$$ ,DEV 
-IF DF L$SSI1 
.WORD PRI 
.IFF 
-WORD “C<PRI>&PR7 
~ENDC 
-IF GT NCTRLR-$$$-1 
BR LAB 
.~ENDC 
$$$=$$$+1 
.ENDR 
LAB: 
~ENDC 
. ENDC 
GTUCBS UCBSV,NCTRLR 
»ENDM 


C.3.9 INTSVS$ Macro 
INTSVS causes interrupt save generation for non-error logging devices. 


«MACRO INTSVS$ DEV,PRI,NCTRLR,PSWSV,UCBSV 
-IF NDF LSSDRV ! MSSMGE ! LDS'DEV 
-IF GT NCTRLR-1 

-IF B <PSWSV> 

MFPS TEMP 

~IFF 

MFPS PSWSV 

-ENDC 

.IFTF 

JSR RS5S,SINTSV 

-IF DF LS$S$SI1 

-WORD PRI 

.IFF 

«WORD “C<PRI>&PR7 

-ENDC 

.IFT 

.IF B <PSWSV> 
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MOV TEMP,R4 

-IFF 

MOV PSWSV,R4 

-ENDC 

BIC #177760,R4 

ASL R4 

-ENDC 

» ENDC 

GTUCBS UCBSV,NCTRLR 
-ENDM 


C.3.10 MFPS/MTPS Macros 


These macros either read or write processor status. 


-IF NDF LS$SIl 
~MACRO MFPS DST 
MOVB @#PS,DST 
»ENDM 

»MACRO MTPS SRC 
-IF IDN <#0>,<SRC> 
CLRB @#PS 

 IFF 

MOVB SRC,@#PS 
~ENDC 

~ENDM 

-ENDC 


C.3.11 RETURN Macro 
RETURN generates an RTS PC instruction. 


»MACRO RETURN 
RTS PC 
- ENDM 


C.3.12 SAVNR Macro 


SAVNR causes a jump to a subroutine to save nonvolatile registers. 


-MACRO SAVNR 
JSR R5,$SAVNR 
~ENDM 


C.3.13 SCBLB Macro 


SCBLB generates a general status control block reference label. 


~IF DF ES$S$DVC 

«MACRO SCBLB NUM,NAM 
«WORD $'NAM'NUM 
-ENDM 

»ENDC 
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C.3.14 SETD Macro 


SETD sets the floating-point processor to double precision mode. 


«MACRO SETD 
~WORD 170011 
- ENDM 


C.3.15 SOB Macro 
SOB generates a decrement loop. 


-IF NDF RSSEIS 
-MACRO SOB A,B 
DEC A 
BNE B 
- ENDM 
- ENDC 


C.3.16 STD Macro 


STD stores a single or double proecision word from the floating-point 
processor. 


»MACRO STD A,B 
e-NTYPE N,A 
-NTYPE M,B 


»-WORD 174000+<N*64 .>+M 
-ENDM 


C.3.17 STFPS Macro 
STFPS stores the floating-point processor's status. 


»-MACRO STFPS A 


eNTYPE N,A 
«WORD 170200+N 
-ENDM 


C.3.18 STST Macro 


STST stores the floating-point exception code and exception address 
pointer. 


«MACRO STST A 

«WORD 170337 

~WORD FLSTS 

- ENDM 

- ENDC 

-IIF NDF SSSYDF, .LIST 
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C.3.19 SWSTKS Macro 
SWSTKS calls SSWSTK to switch system states. 


»-MACRO SWSTKS ARG 
CALL $SSWSTK ,ARG 
-ENDM 

-IF DF FSSLPP 


C.3.20 LDD Macro 
LDD loads double precision floating-point word into the accumulator. 


-MACRO LDD A,B 

-NTYPE N,A 

eNTYPE M,B 

~-WORD 172400+<M*64 .>+N 
-ENDM 


C.3.21 LDFPS Macro 
LSFPS loads floating-point status. 


»-MACRO LDFPS A 

-IF IDN <A>,<@H.FPSA(R2) > 
-WORD 170100+72 

-WORD H.FPSA 


sl FF 

-NTYPE N,A 
-WORD 170100+N 
-» ENDC 

-ENDM 


C.4 FILES-11 HEADER OFFSETS MACRO DEFINITIONS 


C.4.1 FHDO1S Macro 
FHDO1S defines Files-ll offsets. 


-MACRO FHDO1$ OFFSET 
-MCALL DEFSI,OFFSET,DEFINS 
-IF DF,H.FPRO 

«ERROR 

« ENDC 


Header Area Offsets 


DEFSI 0 

OFFSET H.IDOF,1 ;IDENT area offset in words 

OFFSET H.MPOF,1 ;Map area offset in words 

OFFSET H.FNUM,2 +File number 

OFFSET H.FSEQ,2 ‘File sequence number 

OFFSET H.FLEV,2 ;Structure level and system number 
OFFSET H.FOWN ;Owner of file consisting of: 
OFFSET H,.PROG,1 ; Programmer number 
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OFFSET H.PROJ,1 ; Project number 
OFFSET H.FPRO,2 ; File protection code 


File Protection Bits 


;Read access allowed if clear 
:Write access allowed if clear 
sExtend access allowed if clear 
;Delete allowed if clear 
;Read attributes allowed if clear 
;File characteristics code 
; consisting of: 
; User controlled characteristics byte 


DEFINS FP.RDV,1 

DEFINS FP.WRV,2 

DEFINS FP.EXT,4 

DEFINS FP.DEL,10 
DEFINS FP.RAT,1 

OFFSET H.FCHA 


OFFSET H.UCHA,1 
Bit Definitions for User Controlled Characteristics Byte 
;File is logically contiguous if set 
;Deaccess lock set if bit is set 


»System controlled characteristics 
7 byte 


DEFINS UC.CON,200 
DEFINS UC.DLK,100 
OFFSET H.SCHA,1 


Bit Definitions for System Controlled Characteristics Byte 


;Marked for delete if set 

;Bad data block in file if set 
s;User file attributes 

;Size in bytes of header area 


DEFINS SC.MDL,200 
DEFINS SC.BAD,100 
OFFSET H.UFAT, 32. 
OFFSET S.HDHD 


Ident Area Offsets 


DEFSI 0 
OFFSET I.FNAM,6 ;File name in RAD50 
OFFSET I.FTYP,2 7File type in RAD50 
OFFSET I.FVER,2 ;File version number in binary 
OFFSET I.RVNO,2 ;Revision number 
OFFSET I.RVDT,7 ;Revision date 
OFFSET I.RVTI,6 ;Revision time 
OFFSET I.CRDT,7 ;Creation date 
OFFSET I.CRTI,6 ;Creation time 
OFFSET I.EXDT,7 ;Expiration date 
OFFSET ,1 Round up to word boundary 
OFFSET S.IDHD ;Size in bytes of IDENT area 
DEFINS I.DASZ,7 ;Number of bytes in date string 
DEFINS I.TISZ,6 ;Number of bytes in time string 


C.4.2 FHDOFS Macro 


FHDOFS defines Files-1l header offsets. 


FHDOFS 
FHDOFS$S 


~-MACRO FHDOF$ GLOBAL 


»MCALL 
.. -GBL 
IF B, 
FHDO1S 
~IFF 


-IF IDN,<GLOBAL> ,<DEFSG> 


-. <GBL 
FHDOLS 


FHDOFS 
DEFSL 
DEFS$G 


FHDO1S 
=0 
GLOBAL 

DEFSL 
=] 


GLOBAL 


;Define offsets locally 
;Define offsets locally 
;Define offsets globally 
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~ENDC 

-IF DIF,<GLOBAL> , <DEFSN> 

»-MACRO FHDOFS ARG1 s;Redefine macro 
~ENDM FHDOFS 

» ENDC 

~ENDM FHDOFS 


Map Area Offset 


DEFSI 0 

OFFSET M.ESQN,1 ;Extension sequence number 

OFFSET M.ERVN,1 ;Extension relative volume number 
OFFSET M.EFNU,2 ;Extension file number 

OFFSET M.EFSQ,2 ;Extension file sequence number 
OFFSET M.CTSZ,1 ;Block count field size 

OFFSET M.LBSZ,1l ;Logical block number field size 
OFFSET M.USE,1 ;Words in use in the map 

OFFSET M.MAX,1 ;Max number of words available in map 
OFFSET M.RTRV ;Start of retrieval pointers 
OFFSET S.MPHD ;Size in bytes of the map area 


Checksum for File Header 


DEFINS H.CKSM,510. Sum of words 0-255. 
-IF DIF,<OFFSET> ,<DEFSN> 
»MACRO FHDOLS ARG1 
»-ENDM FHDOLS 
~ENDC 
»-ENDM FHDO1S 


C.4.3 HMBOFS And HMBO1$S Macros 


HMBOFS and HMBO1S define Files-1l home block offsets. 


HMBOFS ;Define offsets locally 
HMBOFS DEFSL Define offsets locally 
HMBOFS DEFSG ;Define offsets globally 


-MACRO HMBOFS GLOBAL 
-MCALL HMBO1S 

.. GBL=0 

-IF B,GLOBAL 

HMBO1LS DEFSL 

-IFF 

-IF IDN,<GLOBAL> , <DEF$G> 
-. -<GBL=1 

-ENDC 

HMBO1$ GLOBAL 

»ENDC 

-IF DIF,<GLOBAL> ,<DEFSN> 
-MACRO HMBOFS ARG1 

-ENDM HMBOFS 

-» ENDC 

-ENDM HMBOFS 

-MACRO HMBO1S OFFSET 
-MCALL DEFSI,OFFSET,DEFINS 


DEFSI 0 

OFFSET H.IBSZ,2 ;Index bit map size 

OFFSET H.IBLB,4 ;Index bit map LBN 

OFFSET H.FMAX,2 ;Maximum number of files on volume 
OFFSET H.SBCL,2 ;Storage bit map cluster factor 
OFFSET H.DVTY,2 ;Disk device type 

OFFSET H.VLEV,2 ;Structure level 
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OFFSET H.VNAM,12. ;Volume name - ASCII 

OFFSET ,4 : RESERVED 

OFFSET H.VOWN,2 3;Volume owner's UIC 

OFFSET H.VPRO,2 7Volume protection code 
OFFSET H.VCHA,2 ;Volume characteristics 


New Home Block Information Down to H.FIEX 


OFFSET H.DFPR,2 ;Default file protection 

~lF DF,H.FPRO 

» ERROR ;Tried to multiply define H.FPRO 

-ENDC 

-IF DF,RSS11M 

OFFSET H.VFSQ,2 ;Volume file sequence number 
;Updated by dismount 

LFF 

OFFSET ,2 ;Not used 

»ENDC 

OFFSET ,4 sNot used 

OFFSET H.WISZ,1 ;Window size for all files on volume 

OFFSET H.FIEX,1 *sDefault file extend in blocks 

OFFSET H.LRUC,1 ;Number of entries in directory LRU 

OFFSET ,1ll. s;Available 

OFFSET H.CHK1,2 *Checksum of words 0-28. 

OFFSET H.VDAT,14. ;Creation date 

OFFSET ,398. Reserved for relative volume table 

OFFSET H.INDN,12. ;System independent volume name 

OFFSET H,INDO,12. ;System independent owner name 

OFFSET H.INDF,12. ;System independent format type 

OFFSET ,2 sNot used 

OFFSET H.CHK2,2 sChecksum of words 0-255. 


.IF DIF,<OFFSET> ,<DEFSN> 
-MACRO HMBO1S ARG1 

-ENDM HMBO1LS 

~ENDC 

~ENDM HMBOI1S 

~IIF NDF,SSSYDF,.LIST 


C.5 FILE CONTROL SERVICES MACRO EXPANSIONS 


C.5.1 BDOFFS Macro 


BDOFFS generates the buffer descriptor offsets. The same type of call 
occurs as for file descriptor offsets. 


»-MACRO BDOFFS OFFSET 
-MCALL OFFSET,DEFSI 


DEFSI 0 

OFFSET ,4 

OFFSET B.VBN,4 ;Virtual block number for this buffer 
OFFSET B.BBFS,2 ;NUMBER OF bytes read or written 

OFFSET B.NXBD,2 ;Pointer to next buffer descriptor 

OFFSET ,1l ;Spare byte 

OFFSET B.BFST,1 ;Buffer status byte 

OFFSET ,2 ; 


OFFSET S.BFHD 
-IIF IDN,<DEFSN>,<OFFSET>,.MEXIT 
-MACRO BDOFF$ ARG 
»ENDM BDOFFS 
ENDM BDOFFS$ 
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C.5.2 CBYTE$ Macro 
CBYTES conditionally assembles a .BYTE directive for VAR at the 
specified offset. from the beginning of the FDB. 


~-MACRO CBYTES VAR,OFFSET 


-IF NB,VAR 7;If£ non null 

«2 -PC2=, ;Save PC 

»*...PC1+OFFSET 7;Set PC to specified offset 
~-BYTE VAR ;Assemble the byte 

o=..-PC2 ;Restore PC 

»ENDC 


»ENDM CBYTES 


C.5.3 CLOSES Macro 
CLOSES closes a file. 


-MACRO CLOSES FDB,ERR 
-MCALL LDFDBS ,ERRS 
LDFDBS FDB 

-GLOBL .CLOSE 

JSR PC,.CLOSE 

ERR$ ERR 

-ENDM CLOSES 


C.5.4 CMOVS2 Macro 


CMOV$2 conditionally moves two words from VAR to the specified offset 


of RO. 


-MACRO CMOVS2 VAR,OFFSET 
-IIF B,VAR,.MEXIT 


MOV VAR,-(SP) ;Address of 2 words to state 
MOV @(SP) ,OFFSET(RO) sFirst word to FDB 
ADD #2, (SP) sCalculate address of 2nd word 


MOV @(SP)+,OFFSET+2(RO) ;2nd word to FDB 
~ENDM CMOVS2 


C.5.5 CMOVSB Macro 


CMOVSB conditionally generates a MOVE BYTE instruction to move a_ byte 


to the specified offset of RO. 


-MACRO CMOVSB VAR,OFFSET 
-IF IDN,<#0>,<VAR> 

CLRB OFFSET (RQ) 

-MEXIT 


«ENDC 
-IIF NB,VAR, MOVB VAR,OFFSET (RO) 


-ENDM CMOVSB 
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C.5.6 CMOVSW Macro 
CMOVSW conditionally moves a word to the specified offset of RO. 


»~MACRO CMOVSW VAR,OFFSET 

~IF IDN,<#0>,<VAR> 

CLR OFFSET (RO) 

-MEXIT 

- ENDC 

~IIF NB,VAR, MOV VAR,OFFSET (RO) 
-ENDM CMOVSW 


C.5.7 CWORDS Macro 


CWORDS conditionally assembles a .WORD directive for VAR at the 
specified offset for the beginning of the FDB. 


MACRO CWORDS VAR,OFFSET 


-LF NB,VAR :If VAR is not null 

~»-PC2=, sSave the PC 

-=...PCI+OFFSET ;Set the PC to the specified offset 
»~WORD VAR sAssemble the word 

o=...PC2 ;Restore the PC 

~ENDC 


»ENDM CWORDS 


C.5.8 DEF$G Macro 
DEFSG defines offsets globally. 


-MACRO DEFSG VAR,SIZ ;Define global offset 
-MCALL DEFSL 

-LIF NB,VAR,.GLOBL VAR 

DEFSL VAR,SIZ 

-ENDM DEFSG 


C.5.9 DEFSI Macro 


»-MACRO DEFSI IVAL ;Initialize definition 
...TPC="O<XIVAL> ;Macros program counter 
»-ENDM DEFSI 


C.5.10 DEFSL Macro 


»-MACRO DEFSL SYM,SIZ 
.IF NB,SYM 
SYM="0O<...TPC> 

-ENDC 

.IF NB,SIZ 
..-TPC="O<...TPCtSIZ> 
~ENDC 

-ENDM DEFSL 
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C.5.11 DEFSN Macro 
DEFSN updates ...TPC but does not define the symbol. 


«MACRO DEFSN VAR,SI2Z sDefine no offset-calculate the size 
~MCALL DEFSL 

DEFSL ,SIZ 

~ENDM DEFSN 


C.5.12 DEFINS Macro 


DEFINS equates the symbol with its specified value and defines it 
globally if ...GBL = 1. Otherwise, it locally defines the symbol. 


»-MACRO DEFINS SYM,VAL 

-IIF EQ,...GBL-1,.GLOBL SYM 
SYM=“Q<VAL> 

-ENDM DEFINS 


C.5.13 DELETS Macro 
DELETS deletes a file. 


-MACRO DELETS FDB,ERR 
-MCALL LDFDBS$ ,ERRS 
LDFDB$ FDB 

-GLOBL .DELET 

JSR PC,.DELET 

ERRS$ ERR 

-ENDM DELETS$ 


C.5.14 FCSBT$ Macro 


FCSBT$ defines FCS bits and values locally or globally. Call with 
DEF$SG for global definitions; conventionally called with DEFSL for 
local, but anything not equal to DEFSG will do 


- MACRO FCSBT$ GLOBL 
-MCALL DEFINS 

-.-GBL=0 

~IIF IDN,<GLOBL> ,<DEFSG>,...GBL=1 


F.RATT bits - Record Attribute Byte 


DEFINS FD.FTN,1 ;FORTRAN carriage control bit 

DEFINS FD.CR,2 sInsert carriage returns between 
s records 

DEFINS FD.PRN,4 7;R.SEQ/VFC print file 

DEFINS FD.BLK,10 371 if records cannot cross block 


;boundaries 


F.RACC bits - Record Access Byte 


DEFINS FD.RWM,1 On if read/write, off if GET/PUT 
DEFINS FD.RAN,2 ;On if random, off if sequential 
DEFINS FD.PLC,4 ;On if partial locate, off if 

; sequential 
DEFINS FD.INS,10 ;On if put sequential insert 


smode; off if truncate mode 
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F.RCTL bits - Record Control Byte - Device Characteristics 


DEFINS FD.REC,1 


DEFINS .D.CCL,2 
device; 


DEFINS FD.TTY,4 
DEFINS FD.DIR,10 


DEFINS FD.SDI,20 
DEFINS FD.SQD,40 
DEFINS FD.ISP,2000 
DEFINS FD.OSP,4000 
DEFINS FD.PSE,10000 
DEFINS FD.COM,20000 
DEFINS FD.F11,40000 
DEFINS FD.MNT,100000 


N.STAT Bits - File Name Block Status 


DEFINS NB.VER,1 
DEFINS NB.TYP,2 
DEFINS NB.NAM,4 
DEFINS NB.SVR,10 
DEFINS NB.STP,20 
DEFINS NB.SNM,40 
DEFINS NB.DIR,100 


DEFINS NB.DEV,200 

DEFINS NB.SD1,400 
PPN 

DEFINS NB.SD2,1000 
PPN 


3O0n if record oriented device, 
;off if block oriented 
7On if carriage control output 


s;off if not 

7On if this device is a TTY 

7On if directory device, off if 
s;not 

7On if single directory device 
7O0n if sequential device 

sInput spooling 

;Output spooling 


Word - Set by parse 


;Set if file version was explicit 
;Set if file type was explicit 
7;Set if file name was explicit 
7;Set if * in version field 

Set if * in type field 

;Set if * in name field 

;Set if explicit directory 
;~pecified 

;Set if device name was explicit 
;Set if * in project number of 


7;Set if * in programmer number of 


***k*k* NOTE: MORE BITS IN N.STAT ARE LOCALLY USED BY FCS 


Check Definition Section in FCS 
F.RTYP Values - Record Type Byte 
Note: These are values, not bits 


DEFINS R.FIX,1 
DEFINS R.VAR,2 
DEFINS R.SEQ,3 


F.FACC Bits - File Access Byte 


DEFINS FA.RD,1 

DEFINS FA.WRT,2 
DEFINS FA.EXT,4 
DEFINS FA.CRE,10 
DEFINS FA.TMP,20 
DEFINS FA.SHR,40 


The following two names apply to the 


;Fixed length records 
;Variable length records 
;Sequenced records 


;Set if read only 

;Set if accessed for write 
;Set if access for extend 

;Set if creating new file 

;Set if creating temp file 
;Set if shared access 


same control bit in F.FACC: 


FA.APD is only used if the file is an existing file 


FA.CRE=0) ; 


FA.NSP is only used if the file is being created 


(FA.CRE=1) 


DEFINS 
DEFINS 


DEFINS 
DEFINS 
DEFINS 
DEFINS 
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FA.APD,100 ;Set if appending (POSIT to EOF) 

FA.NSP,100 7Set if inhibiting supersede on 
;file creation 

FO.RD,FA.RD ;Open for read 


FO.WRT,FA.WRT!FA.EXT!IFA.CRE ;Open for write (create) 
FO.APD,FA.WRT!IFA.EXT!IFA.APD ;Open for append 
FO.MFY,FA.WRT ;Open for modify 


FO.UPD,FA.WRT!FA.EXT ;Open for update 


Bits in F.ACTL 


in the FDB - Several of these bits also have local 


definitions in FCSPRE.MAC; however, all definitions are mutually 


exclusive. 


DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 


DEFINS 


FA.ENB,100000 ;Enable use of F.ACTL word 

FA.WCK,20000 s;Enable write check 

FA.SEQ,40000 ;Enable sequential processing only 

FA.DLK,1000 sEnable no lock on abnormal close 

FA.RWD,4000 ;Enable rewind control for magtape 

FA.POS ,10000 ;File creation position control for 
;Magtape 

FA.EXC,2000 ;Exclusive use bit 


F.CHR Bits - ACP Global Volume Characteristics 


DEFINS 


CH.AND,1 sANSI 'D' format 


F.MBFG Bits ~ Multiple Buffering Flag Word - 


DEFINS 


DEFINS 


FD.RAH,1 yRead ahead if set - this or write 


* behind 
FD.WBH,2 :Write behind if set - not both 


Note: More bits in F.MBFG used in FCS locally 


-CTRL Function 


DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
. MACRO 


Codes 

FF.RWD,1 ; Rewind 

FF.POE,2 Position to end of volume (set) 
FF.NV,3 ;Next volume 

FF.SPC,4 — ;Space 

FF.CHR,5 7;Get APC characteristics 

FF .RWF,6 sERS rewind file 

FCSBTS ARG 


~ENDM FCSBTS 
.ENDM FCSBTS 


C.5.15 FCSMC$ 


Macro 


FCSMCS executes an MCALL for all the FCS macros. 


«MACRO 
-MCALL 
-MCALL 
»MCALL 
-MCALL 
-MCALL 
-MACRO 


FCSMCS 

OPENSR,OPENSW,OPENSM,OPENSU ,OPENSA,CLOSES 
OPNSSR,OPNSSW,OPNSSM,OPNSSU ,OPNSSA 

READS ,WRITES ,WAITS ,GETS ,PUTS ,DELETS , FINITS 
FSRSZS$ ,FDBDF$ ,FDATSA,FDRCSA,FDOPSA,FDBFSA,FDBKSA 
FDATSR,FDRCS$R,FDOPS$R,FDBFSR,FDBKSR,NMBLKS 

FCSMC$ 


-ENDM FCSMCS$ 
»-ENDM FCSMCS 
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C.5.16 FDATSA Macro 


FDATSA initializes the file attribute section of the FDB at assembly 
time. 


»-MACRO FDATSA RTYP,RATT,RSIZ,CNTG,ALOC 
»MCALL FDOFFS$ ,CBYTES ,CWORDS 

FDOFFS DEFSL 

CBYTES <RTYP>,F.RTYP 

CBYTES <RATT>,F.RATT 

CWORDS <RSIZ>,F.RSIZ 

CWORDS <CNTG>,F.CNTG 

CWORDS <ALOC>,F.ALOC 

~ENDM FDATSA 


C.5.17 FDATSR Macro 
FDATSR initializes the file attribute section of the FDB at run time. 


»-MACRO FDATSR FDB,RTYP,RATT,RSIZ,CNTG ,ALOC 
-MCALL LDFDBS ,CMOVSW,CMOVSB 

LDFDBS FDB ;Load FDB address 
CMOVSB RTYP,F.RTYP 

CMOVSB RATT,F.RATT 

CMOVSW RSIZ,F.RSI2Z 

CMOVSW CNTG,F.CNTG 

CMOVSW ALOC,F.ALOC 

.ENDM FDATSR 


C.5.18 FDBDF$ Macro 
FDBDF$ allocates space at assembly time for the FDB. 


.MACRO FDBDFS 
.MCALL FDBS2Z$ 
FDBSZ$ 

~e PCl=. 
-BLKB S.FDB 
-ENDM FDBDFS$ 


C.5.19 FDBFSA Macro 


FDBFSA intializes the buffer descriptor section of the FDB at assembly 
time. 


»MACRO FDBFSA EFN,OVBS ,MBCT,MBFG 
-MCALL FDOFFS ,CBYTES ,CWORDS 
FDOFF$ DEFSL 

CBYTES <EFN>,F.EFN 

CWORDS <OVBS>,F.OVBS 

CBYTES <MBCT>,F.MBCT 

CBYTES <MBFG>,F.MBFG 

-ENDM FDBFSA 
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C.5.20 FDBFSR Macro 


FDBFSR initializes the block buffer section of the FDB at run time. 


. MACRO 
MCALL 
LDFDBS 
CMOVSB 
CMOVSW 
CMOVSB 
CMOVSB 


FDBFSR FDB,EFN,OVBS ,MBCT,MBFG 
LDFDBS ,CMOVSW,CMOVSB 


FDB 
EFN,F.EFN 
OVBS ,F.OVBS 
MBCT,F.MBCT 
MBFG,F.MBFG 


-ENDM FDBFSR 


C.5.21 FDBKSA 


Macro 


;Event flag to use 

:Size of block buffer 

:No. of buffers 

:Read ahead or write behind 


FDBKSA initializes the block access section of the FDB at assembly 


time. 


. MACRO 
-MCALL 
FDOFFS 
CWORDS 
CWORDS 
CWORDS 
CBYTES 
CWORDS 
CWORDS 


FDBKSA BKAD,BKSZ,BKVB,BKEF,BKST,BKDN 
FDOFFS ,CBYTES ,CWORDS$ 


DEFSL 
<BKAD>,F.BKDS+2 
<BKSZ>,F.BKDS 
<BKVB> ,F.BKVB+2 
<BKEF>,F.BKEF 
<BKST>,F.BKST 
<BKDN>,F.BKDN 


-ENDM FDBKSA 


C.5.22 FDBKSR 


Macro 


:Store low order only 


FDBKSR initializes the block access section of the FDB at run time. 


- MACRO 
-MCALL 
LDFDBS$ 
CMOVSW 
CMOVSW 
CMOV$ 2 


CMOVSB 
CMOVSW 
CMOVSW 


FDBKSR FDB,BKAD,BKSZ,BKVB,BKEF,BKST,BKDN 
LDFDBS ,CMOVSB,CMOVSW,CMOV$ 2 


FDB 

BKAD ,F.BKDS+2 
BKSZ,F.BKDS 
BKVB,F.BKVB 


BKEF,F.BKEF 
BKST,F.BKST 
BKDN ,F .BKDN 


-ENDM FDBKSR 


C.5.23 FDBS2$ 


Macro 


;Block address-memory buffer 
:;Size of transfer in bytes 
;Address of 2 word virtual 
Block number, move both words 
;Event flag 

ADR OF I/O STATUS BLOCK 
s:Address of I/O done AST 


FDBSZ$ defines the size of the FDB as a local symbol (S.FDB). 


-» MACRO 


FDBSZ$ 


~-IIF DF,S.FDB,.MEXIT 


.MCALL 
FDOFFS 


FDOFFS ,DEFSL 
DEFSN 


DEFSL S.FDB 
-ENDM FDBS2$ 


;Define S.FDB as size of FDB 


sInvoke offset definitions but do 
; not actually define che offset 
; names 

:Now define S.FDB 


MACRO EXPANSIONS 


C.5.24 FDOPSA Macro 


FDOPSA initializes the file open section of the FDB at assembly time. 


» MACRO 
.MCALL 
FDOFFS 
CBYTES 
CWORDS 
CWORDS 
CBYTES 
CWORDS 


FDOPSA LUN, FNPT,DFNB,FACC,FACTRL 
FDOFFS ,CBYTES , CWORDS 

DEFSL 

<LUN> ,F.LUN 

<FNPT>,F.DSPT 

<DFNB> ,F.DFNB 

<FACC>,F.FACC 

<FACTRL> ,F.ACTL 


~ENDM FDOPSA 


FDOPSR 


. MACRO 
.MCALL 
LDFDBS$ 
CMOVSB 
CMOVSW 
CMOVSW 
CMOVSB 
CMOVSW 


Macro 


FDOPS$R FDB,LUN,FNPT,DFNB,FACC,FACTRL 
LDFDBS ,CMOVSW,CMOVSB 

FDB 

LUN,F.LUN 

FNPT,F.DSPT 

DFNB,F.DFNB 

FACC,F.FACC 

FACTRL,F.ACTL 


-ENDM FDOPSR 


FDOPSR initializes the file open section of the FDB at run time. 


C.5.26 EFDRCSA Macro 


FDB at assembly 


FDRCSA initializes the record access section of the 


. MACRO 
»MCALL 
FDOFFS 
CBYTES 
CWORDS 
CWORDS 


FDRCSA RACC,URBA,URBS 
FDOFFS ,CBYTES , CWORDS 
DEFSL 

<RACC>,F.RACC 
<URBA> ,F .URBD+2 
<URBS> ,F.URBD 


~-ENDM FDRCSA 


FDRCSR 


«MACRO 
-MCALL 
LDFDB$ 
CMOVSB 
C...VSW 
CMOVSW 


Macro 


FDRCSR FDB, RACC,URBA,URBS 
LDFDBS ,CMOVSW,CMOVSB 

FDB 

RACC ,F.RACC 

URBA,F.URBD+2 

URBS,F.URBD 


-ENDM FDRCSR 


C~87 


FDRCSR initializes the record access section of the FDB at run time. 


C.5.28 FDOFSL 


Macro 


MACRO EXPANSIONS 


FDOFSL calls FDOFFS to locally define offsets. This action occurs 


only once. 


.MACRO 
.MCALL 
FDOFFS 


FDOFSL 
FDOFFS 
DEFSL 


-ENDM FDOFSL 


C.5.29 FDOFFS 


Macro 


FDOFF$ is the File Descriptor Block definition macro. It is called 
with one of the following macro names: DEFSL, DEFS$G, or DEFSN. DEFSL 
defines local offsets, DEFSG defines total offsets, and DEFSN defines 
the size of the FDB. 


-MACRO FDOFFS OFFSET 


»-MCALL OFFSET,DEFSI,NBOFFS 


NBOFFS 


DEFSI 0 


File Attribute 


OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 


OFFSET 


Section 


F.RTYP,1 
F.RATT,1 
F.RSIZ,2 
F.HIBK,4 
F.EFBK,4 
F.FFBY,2 
S.FATT 


Record Access Section 


OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 


F.RACC,1 
F.RCTL,1 
F.BKDS 
F.URBD,4 
F.BKST 
F.NRBD,2 
F.BKDN 

f 

F.OVBS 
F.NREC ,2 
F.EOBB,2 
F.CNTG 
F.RCNM,2 
F.STBK 
ye 
F.ALOC ,2 


File Open Section 


OFFSET 
OFFSET 
OFFSET 
OFFSET 


F.LUN,1 

F.FACC,1 
F.DSPT,2 
F.DFNB,2 


sInitialize the definition macro 


;Record type 

;Record attributes 

;Record size 

Highest virtual block no. allocated 
End of file block number 

;First free byte in last block 

;Size of file attribute section 


,Record access 

;Record control 

Block I/O - buffer descriptor 
;User's record buffer descriptor 
:Block I/O - I/O status block address 
;Next record buffer descriptor 
;Block I/O ~ I/O done AST address 
32nd word of NRBD 

Override block buffer size 

;Next record address in block buffer 
sEnd of block buffer 

;Size in blocks of contiguous file 
;Record number for random records 
sAddress to read in statistics block 
72nd word of RCNM 

;Allocate this much space when need 
;To extend, + = contig, - = not 


;Logical unit number 

;File access 

;File descriptor pointer 
;Default file name block address 


Block Buffer Se 


ction 


MACRO EXPANSIONS 


OFFSET F.BKEF ;Block I/O - event flag number 
OFFSET F.EFN,1 ;Event flag used in QIO 
OFFSET F.BKP1,1 ;Bookkeeping bits 
OFFSET F.ERR,2 ;lst byte error return code 
72nd byte for QIO error indicator 
OFFSET F.MBCT,1 ;Number of buffers to use (desired) 
OFFSET F.MBC1,1 ;Number of buffers in use 
OFFSET F.MBFG,1 ;Multiple buffering control flags 
OFFSET F.BGBC,1 ;Big buffer block count (size in 
3; blocks) 
OFFSET F.VBSZ,2 ;Virtual block size in bytes 
OFFSET F.BBFS,2 *Block buffer size 
OFFSET F.BKVB *;Block I/O - virtual block number 
OFFSET F.VBN,4 ;Virtual block number : 
OFFSET F.BDB,2 ;Block buffer descriptor block 
OFFSET F.SPDV,2 ;Spool device indicator 
OFFSET F.SPUN,1 ;Spool unit designator 
OFFSET F.CHR,1l ;ACP volume characteristics summary 
; byte 
OFFSET F.ACTL,2 ;Access control word 
OFFSET F.SEQN,2 ;Sequence number for sequenced files 


File Name Block Section 


OFFSET F.FNB,S.FNB ;Beginning of file name block 
~IIF IDN,<OFFSET>,<DEFSN>,.MEXIT — 

~-IF IDN,<OFFSET> ,<DEFSG> 

-GLOBL F.FNAM,F.FTYP,F.FVER,F.DVNM,F.UNIT 

» ENDC 
F.FNAM=N.FNAM+F.FNB 
F.FTYP=N.FTYP+F.FNB 
F.FVER=N.FVER+F.FNB 
F.DVNM=N ..DVNM+F.FNB 
F.UNIT=N.UNIT+EF.FNB 
OFFSET S.FDB 

-MACRO FDOFFS ARG 
»-ENDM FDOFFS 

-ENDM FDOFFS$ 


sSize of FDB 


C.5.30 FDSOFS$ Macro 


FDSOF$ defines offsets relative to the file descriptor pointer, 
F.DSPT. 


»-MACRO FDSOFS OFFSET 
»MCALL OFFSET,DEFSI ,DEFSL 
DEFSI 0 

OFFSET N.DEVD,4 
OFFSET N.DIRD,4 
OFFSET N.FNMD,4 
OFFSET S.FIDS 
.IF IDN,<DEFSN>,<OFFSET> 
DEFSL S.FIDS 

.MEXIT 

-ENDC 

.MACRO FDSOFS ARG 

-ENDM FDSOFS 

-ENDM FDSOFS 


;Device string descriptor 
;Directory string descriptor 
;File name string descriptor 


MACRO EXPANSIONS 


C.5.31 FINITS and FSRSZ$ Macros 
FINITS and FSRSZS initialize the file control services. 


»MACRO FINITS 

-GLOBL .FINIT 

JSR PC,.FINIT 

-ENDM FINITS 

»-MACRO FSRSZS NFILES,BFSPAC,PSECT 
»MCALL BDOFFS ,DEFSL 

-IF NDF,S.BFHD 

BDOFFS DEFSN 

DEF$L S.BFHD 

»ENDC 

-GLOBL .FSRCB 

-PSECT S$FSR1,GBL,OVR,D 

»IF NB,<BFSPAC> 

»-BLKB NFILES*S.BFHD+<BFSPAC> 
~IFF 

-BLKB NFILES*<S.BFHD+512.> 
-ENDC 

»PSECT PSECT 

-ENDM FSRS2$ 


C.5.32 FSROFS Macro 
FSROFS generates the file storage region offsets. 


»MACRO FSROFS OFFSET 
»MCALL OFFSET,DEFSI,DEFSL 


Define the Offsets for S$SFSR2 


DEFSI 0 

OFFSET ,4 s;List head for allocation 
OFFSET A.BFSR,2 ;First address in FSRI1 
OFFSET A.EFSR,2 :;Last address in FSRI1 


xkkkKk*E DO NOT SEPARATE THE FOLLOWING 2 DEFINITIONS 

OFFSET A.OWUI,2;UIC of owner (from task header) 

OFFSET A.FIPR,2 :Default file protection word 
*exkkK DO NOT SEPARATE THE PRECEEDING 2 DEFINITIONS 


x***k* DO NOT SEPARATE THE FOLLOWING 3 DEFINTIONS 


OFFSET A.DPB,24. :Q1/0 DPB and scratch area 

OFFSET A.IOST,4 ;Scratch I/O status block 

OFFSET A.DFDR,24. *Default directory information 

kekkk* DO NOT SEPARATE THE PRECEEDING 3 DEFINITIONS 

OFFSET A.DFBC,2 :Default buffer count (multiple 
; buffering) 

OFFSET A.DFUI,2 :Default UIC (task UIC) 

OFFSET S.FSR2 :;Size of file storage region 2 


DEFSL S.FSR2 


Define Offsets Relative to Beginning of the Default Directory Info 


DEFSI 0 

OFFSET ,14. 

OFFSET D.DFID,6 ;Default directory ID 
OFFSET D.DFDV,2 Device name for default 


;directory ID 


OFFSET D.DFUN,2 


MACRO EXPANSIONS 


;Unit number for default 
;directory ID 


-IIF IDN,<DEFSN>,<OFFSET>,.MEXIT 
-MACRO FSROFS ARG 

-ENDM FSROFS 
-ENDM FSROFS 


C.5.33 GETS Macro 


GETS gets a record from a file. 


C.5.34 


.» MACRO 
»MCALL 
LDFDBS 
CMOVSW 
CMOVSW 
-GLOBL 


GET$ FDB,INADR,MAXCNT,ERR 
LDFDBS ,CMOVSW,ERRS 

FDB 
INADR,F.URBD+2 
MAXCNT,F.URBD 
-GET 


sUser record buffer address 
;User record buffer size 


JSR PC,.GET 
ERRS ERR 
-ENDM GETS 


GETSR Macro 


GETSR gets a record in random mode. 


C.5435 


» MACRO 


-MCALL’ 


LDFDBS 
CMOVSW 
CMOVSW 
CMOVSW 
CMOVSW 
.GLOBL 


GETSR FDB, INADR,MAXCNT,LRCNM,HRCNM, ERR 
LDFDBS ,CMOVSW,ERRS 

FDB 

INADR,F.URBD+2 User record buffer address 
MAXCNT,F.URBD User record buffer size 
LRCNM,F.RCNM+2 ;Low order record number 
HRCNM, F.RCNM ;High order record number 
GET 


JSR PC,.GET 
ERRS$ ERR 
-ENDM GETSR 


GETSS Macro 


GETSS gets a record in strictly sequential mode. 


- MACRO 
.MCALL 
LDFDB$ 
CMOVSW 
CMOVSW 
. GLOBL 


GETSS FDB,INADR,MAXCNT,ERR 


LDFDBS , CMOVSW,ERRS 

FDB 

INADR,F.URBD+2 ;User record buffer address 
MAXCNT,F.URBD sUser record buffer size 
-GETSQ 


JSR PC,.GETSQ 
ERRS ERR 
»ENDM GETSS 


C.5.36 NBOFSL Macro 


NBOFSL calls NBOFFS to define offsets as local symbols. 


This 


occurs only once. 


action 


MACRO EXPANSIONS 


-MACRO NBOFSL 
-MCALL NBOFFS 
NBOFFS DEFSL 
~-ENDM NBOFSL 


If the FDB parameter is null or RO, LDFDBS does not move FDB to RO. 
Otherwise, it does move the FDB to RO. 


»~MACRO LDFDBS FDB 

-LIF B,FDB,.MEXIT :I£ null then exit 
-NTYPE PARSSS,FDB 

-LTIF EQ,PARSSS,.MEXIT sI£f RO then exit 

MOV FDB,RO ;Else generate the move 
~-ENDM LDFDBS 


C.5.37 NBOFFS$ Macro 
NBOFFS generates the file name block offsets. 


-MACRO NBOFFS OFFSET 
-MCALL OFFSET,DEFSI,DEFSL 


DEFSI 0 
OFFSET S.FNAM ;Define as global if parameter 
OFFSET S.FTYP ;Is DEFSG 


OFFSET S.FNTY 
OFFSET S.FNBW 


S.FNAM=6 ;Size of filename in bytes 
S.FTYP=2 ;Size of file type in bytes 
S.FNTY=<S.FNAM+S.FTYP>/2 ;Size of filename + type in words 
OFFSET N.FID,6 sFile ID 

OFFSET N.FNAM,S.FNAM :;Filename 

OFFSET N.FTYP,S.FTYP ;Type 

OFFSET N.FVER,2 *Version 

OFFSET S.NFEN ;Size of name file entry in bytes 
DEFSL S.NFEN ;Force at least a local definition 
OFFSET N.STAT,2 ;Status 

OFFSET N.NEXT,2 :;Temp cell for find next 

OFFSET N.DID,6 ;Directory ID 

OFFSET N.DVNM,2 ;Device name in ASCII 

OFFSET N.UNIT,2 ;Unit number 

OFFSET S.FNB ;Size of FNB in bytes 

DEFSL S.FNB ;Force local definition at least 
S.FNBW=S.FNB/2 ;Size of FNB in words 


e-IIF IDN,<DEFSN>,<OFFSET>,.MEXIT ;Don't redefine the macro 
»~MACRO NBOFFS ARG 

-ENDM NBOFFS 

~ENDM NBOFFS 


C.5.38 NMBLKS Macro 
NMBLKS$ defines the file name block at assembly time. 


-MACRO NMBLKS FNAME,FTYPE,VERS,DEVNAM,UNIT 
~-MCALL RAD50$ ,CWORDS ,NBOFF'S 


NBOFFS DEFSL ;Define name block offsets locally 
~IIF NDF,...PC1l,...PC1#=0 

oe ePC3=...PCl ;Preserve ...PC1l 

~- —PCls, 


-=...PC1+N.FNAM 
RAD50$ <FNAME>,S.FNAM/2 


MACRO EXPANSIONS 


-=...PC1+N.FTYP 

RAD50$ <FTYPE>,S.FTYP/2 
CWORDS <VERS>,N.FVER 
.IF NB,DEVNAM 
-=...PC1+N.DVNM 

-WORD "DEVNAM 

.ENDC 

C,ORDS <UNIT>,N.UNIT 
-=...PC1+S.FNB 
~»-PCl=,...PC3 sRestore ...PCl 
-ENDM NMBLKS 


C.5.39 OPENS Macro 
OPENS opens a file. 


-MACRO OPENS FDB,FACC,LUN,FNPT,DFNB,RACC,URBA,URBS,ERR 
«MCALL FDOPSR,FDRCSR,ERRS ,CMOVSB 

FDOPSR FDB,LUN,FNPT,DFNB,FACC 

FDRCSR ,RACC,URBA,URBS 

-GLOBL .OPEN 

JSR PC,.OPEN 

ERRS ERR 

-ENDM OPENS 


C.5.40 OPENSA Macro 
OPENSA opens a file for appending. 


-MACRO OPENSA FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL OPENS 
OPENS FDB,#FO.APD,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OPENSA 


C.5.41 OPENSM Macro 
OPENSM opens a file for modification. 


-MACRO OPENSM FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL OPENS 


OPENS FDB,#FO.MFY,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OPENSM 


C.5.42 OPENSR Macro 
OPENSR opens a file for reading. 


.MACRO OPENSR, FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
».MCALL OPENS 

OPENS FDB,#FO.RD,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OPENSR 


MACRO EXPANSIONS 


C.5.43 OPENSU Macro 
OPENSU opens a file for updating. 


-MACRO OPENSU FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL OPENS 


OPENS FDB,#FO.UPD,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OPENSU 


C.5.44 OPENSW Macro 
OPENSW opens a file for writing. 


.MACRO OPENSW FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL OPENS 
OPENS FDB,#FO.WRT,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OPENSW 


C.5.45 OPNSSA Macro 
OPNSSA opens a shared file for appending. 


»MACRO OPNSSA FDB,LUN,FNPT,RACC,URBA,URBS,ERR 

-MCALL OPENS 

OPENS FDB,#FA.SHR!FO.APD,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OPNSSA 


C.5.46 OPNSSM Macro 
OPNSSM opens a shared file for modification. 


-MACRO OPNSSM FDB,LUN,FNPT,RACC,URBA,URBS,ERR 

-MCALL OPENS 

OPENS FDB,#FA.SHR!IFO.MFY,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OPNSSM 


C.5.47 OPNSSR Macro 
OPNSSR opens a shared file for reading. 


-MACRO OPNSSR FDB,LUN,FNPT,RACC,URBA,URBS,ERR 

-MCALL OPENS 

OPENS FDB,#FA.SHR!FO.RD,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OPNS$R 


C.5.48 OPNS$U Macro 
OPNSSU opens a shared file for updating. 


»-MACRO OPNSSU FDB,LUN,FNPT,RACC,URBA,URBS,ERR 

-MCALL OPENS 

OPENS FDB,#FA.SHR!FO.UPD,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OPNSSU 


MACRO EXPANSIONS 


C.5.49 OPNSSW Macro 
OPNSSW opens a shared file for writing. 


-MACRO OPNSSW FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL OPENS 


OPENS FDB,#FA.SHR!FO.WRT,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OPNSSW 


C.5.50 OPNTSD Macro 


Create, access, and mark for delete a new file not entered in a 
directory. It will be deleted when closed (deaccessed) and will be 
properly deleted if program should terminate abnormally. 


»MACRO OPNTSD FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL OPNTSW 


OPNTSW FDB,LUN,FNPT,RACC,URBA,URBS 
BCS .+6 

JSR PC,.MRKDL 

ERRS$ ERR 

-ENDM OPNTSD 


C.5.51 OPNTSW Macro 


OPNTSW creates and accesses a new file and does enter it in a 
directory. The file may be closed and reopened by file ID. The file 


should be deleted before the program exits otherwise it remains in the 
index file with no directory entry. 


»-MACRO OPNTSW FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
»-MCALL OPENS 


OPENS FDB,#FA.TMP!FO.WRT,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OPNTSW 


C.5.52 OFIDS Macro 
OFIDS opens a file by file ID. 


«MACRO OFIDS FDB,FACC,LUN,FNPT,DFNB,RACC,URBA,URBS,ERR 
»-MCALL FDOPS$R,FDRCSR,ERRS$ ,CMOVSB 

FDOP$R FDB,LUN,FNPT,DFNB,FACC 

FDRCSR ,RACC,URBA,URBS 

-GLOBL .OPFID 

JSR PC,.OPFID 

ERR$ ERR 

-ENDM OFIDS 


C.5.53 OFIDSA Macro 
OFIDSA opens a file by file ID for appending. 


»-MACRO OFIDSA FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL OFIDS 


OFIDS FDB,#FO.APD,LUN,FNPT,,RACC,URBA,URBS,ERR 
~-ENDM OFIDSA 


MACRO EXPANSIONS 


C.5.54 OFIDSM Macro 
OFIDSM opens a file for modification by file ID. 


-MACRO OFIDSM FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL OFIDS 


OFIDS FDB,#FO.MFY,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OFIDSM 


C.5.55 OFIDSR Macro 
OFIDSR opens a file for reading by file ID. 


»MACRO OFIDSR FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
»-MCALL OFIDS 
OFIDS FDB,#FO.RD,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OFIDSR 


C.5.56 OFIDSU Macro 
OFIDSU opens a file for updating by file ID. 


»-MACRO OFIDSU FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL OFIDS 
OFIDS FDB,#FO.UPD,LUN,FNPT,,RACC,URBA,URBS,ERR 
.ENDM OFIDSU 


C.5.57 OFIDSW Macro 
OFIDSW opens a file for writing by file ID. 


»-MACRO OFIDSW FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL OFIDS 
OFIDS FDB,#FO.WRT,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OFIDSW 


C.5.58 OFNBS Macro 
OFNBS opens a file by file name block. 


-MACRO OFNBS FDB,FACC,LUN,FNPT,DFNB, RACC,URBA,URBS,ERR 
-MCALL FDOPSR,FDRCS$R,ERRS ,CMOVSB 

FDOPSR FDB,LUN,FNPT,DFNB,FACC 

FDRCSR ,RACC,URBA,URBS 

-GLOBL .OPFNB 

JSR PC,.OPFNB 

ERRS ERR 

-ENDM OFNBS 


MACRO EXPANSIONS 


C.5.59 OFNBSA Macro 

OFNBSA opens a file by file name block for appending. 
»MACRO OFNBSA FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
»-MCALL OFNBS$ 


OFNBS FDB,#FO.APD,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OFNBSA 


C.5.60 OFNBSM Macro 

OFNBSM opens a file by file name block for modification. 
-MACRO OFNBSM FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
»-MCALL OFNBS 


OFNBS FDB,#FO.MFY,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OFNBSM 


C.5.61 OFNBSR Macro 

OFNBSR opens a file by file name block for reading. 
-MACRO OFNBSR FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL OFNBS ene aa 


OFNBS FDB,#FO.RD,LUN,FNPT,,RACC,URBA,URBS,ERR 
»ENDM OFNBSR 


C.5.62 OFNBSU Macro 

OFNBSU opens a file by file name block for updating. 
»-MACRO OFNBSU FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
«MCALL OFNBS 


OFNBS FDB,#FO.UPD,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OFNBSU 


C.5.63 OFNBSW Macro 

OFNBSW opens a file by file name block for writing. 
«MACRO OFNBSW FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL OFNBS 


OFNBS FDB,#FO.WRT,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OFNBSW 


C.5.64 PUTS Macro 
PUTS puts a record in random or sequential mode. 


-MACRO PUTS FDB,OUTADR,OUTCNT,ERR 
-MCALL LDFDBS$ ,CMOVSW,ERRS 


LDFDBS FDB 
CMOVSW OUTADR,F.NRBD+2 ;Next record buffer address 
CMOVSW OUTCNT,F.NRBD s;Next record buffer size 


-GLOBL 


MACRO EXPANSIONS 


~PUT 


JSR PC,.PUT 
ERRS ERR 
~ENDM PUTS 


C.5.65 PUTSR Macro 


PUTSR puts a record in random mode. 


.» MACRO 
.MCALL 
LDFDBS$ 
CMOVSW 
CMOVSW 
CMOVSW 
CMOVSW 
.-GLOBL 


PUTSR FDB,OUTADR,OUTCNT ,LRCNM,HRCNM, ERR 
LDFDBS ,CMOVSW,ERRS 

FDB 

OUTADR,F.NRBD+2 ;Next record buffer address 
OUTCNT,F.NRBD *Next record buffer size 
LRCNM,F.RCNM+2 sLow order record number 
HRCNM, F.RCNM ;High order record number. 
-PUT 


JSR PC,.PUT 
ERR$ ERR 
-ENDM PUTSR 


C.5.66 PUTSS Macro 


PUTSS puts a record in strictly sequential mode. 


C.5.67 


- MACRO 
-MCALL 
LDFDB$ 
CMOVSW 
CMOVSW 
-GLOBL 


PUTSS FDB,OUTADR,OUTCNT,ERR 

LDFDBS ,CMOVSW,ERRS 

FDB 

OUTADR,F.NRBD+2 ;Next record buffer address 
OUTCNT,F.NRBD sNext record buffer size 
.PUTSQ 


JSR PC,.PUTSQ 
ERR$ ERR 
-ENDM PUTSS 


RADS50$ 


Macro 


.MACRO RAD50$ STRING ,MAXWRD 
oe »PC2=, 
-RAD5SO /STRING/ 

~IF GT,<.-...PC2>-"0<2*MAXWRD> 
.ERROR 


“” 


;String RAD50 - string too long, 
; truncated 


o= O<...PC2+<2*MAXWRD>> 


»MEXIT 


« ENDC 
» REPT 


-ENDR 
-ENDM 


“O<MAXWRD-<<.-—-...PC2>/2>> 
-WORD 0 


RAD50$ 


C.5.68 


MACRO EXPANSIONS 


READS Macro 


READS reads a virtual block. 


C.5.69 TRUNC$ Macro 


TRUNCS truncates a file. 


»MACRO TRUNCS FDB,ERR 
-MCALL LDFDBS ,ERRS 
LDFDBS FDB 

-GLOBL .TRUNC 

JSR PC,.TRUNC 

ERR$ ERR 

»ENDM TRUNCS 


C.5.70 WAITS Macro 


WAITS 


waits for 


I/O completion after a READS 


execution. 


-MACRO WAITS FDB,EFN,BKST,ERR 
»MCALL LDFDBS ,CMOVSW,CMOVSB,ERRS 
LDFDBS FDB 
CMOVSB EFN,F.EFN 
CMOVSW BKST,F.BKST 
-GLOBL .WAIT 
JSR PC,.WAIT 
ERRS$ ERR 
-ENDM WAITS 


C.5.71 WRITES Macro 


WRITES writes a virtual block. 
»MACRO WRITES FDB,BKAD,BKSZ,BKVB,BKEF,BKST,BKDN,ERR 


»MCALL FDBK$R,ERRS 
FDBKSR FDB,BKAD,BKSZ,BKVB, BKEF, BKST, BKDN 
-GLOBL .WRITE 

JSR PC, WRITE 

ERR$ ERR 

-ENDM WRITES 


-MACRO READS FDB,BKAD,BKSZ,BKVB,BKEF,BKST,BKDN,ERR 


-MCALL FDBKSR,ERRS 
FDBKSR FDB,BKAD,BKSZ,BKVB, BKEF ,BKST,BKDN 
.GLOBL .READ 

JSR PC,.READ 

ERRS ERR 

-ENDM READS 


or 


WRITES 


macro 
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C.6 NETWORK SYMBOL DEFINITION MACRO 


C.6.1 COMDFS Macro 


Commom Symbol Module for M/D Networks Implementation 


» MACRO 
-NLIST 
-IF IDN 
-GLOBL 
-GLOBL 
-GLOBL 
-GLOBL 
-GLOBL 


-GLOBL 
-GLOBL 
»GLOBL 
-GLOBL 
»GLOBL 


-GLOBL 
-GLOBL 
- ENDC 
B.OT 
B.UN 
B.RC 
B.RP 
B.RU 


B.NA 
B.UA 
B.MN 
B.MX 
NT.IN 
NT.NS 
CR.UR 


CR.NR 
CR.MX 
CR.NO 
CR.NI1 
CR.N2 
CR.N3 
CR.N4 


BWNrOAW 


CR.N5 
CR.N6 
CR.N7 
CR.N8 
CR.N9 
CR.N10 
CR.Nil 
CR.DI 
CR.DT 
CR.DA 
LB.N=0 
LB.E=2 
CT.IN 
CT.CN 
IA.ABO 


COMDF$ DEF 


<DEF> ,<DEFS$G> 
B.OT,B.UN,B.RC,B.RN,B.RP,B.RU,B.NA,B.UA,B.MN,B.MX 
CT.IN,CT.CN,LB.N,LB.E 
NT.IN,NT.NS 
CR.UR,CR.NR,CR.MX 
CR.NO,CR.N1,CR.N2,CR.N3,CR.N4,CR.N5,CR.N6,CR.NI, 
CR.N10,CR.N11 
CR.N7,CR.N8 
CR.DI,CR.DT,CR.DA 

IA.ISM,IA.ABO,IA.DIS,IA.NFW 
CN.IN,CN.OU,CN.UT,CN.NT 
OB.TA,OB.FS,0OB.SQ,0B.BO,0B.TC,OB.RD,OB.RA,OB.ND, 
OB.DD,OB.BM 
OB.TH,OB.TB,OB.TI,OB.CR,OB.LP,OB.PR,OB.PP,OB.PL,OB.MT 
OB.DT,OB.CS,OB.CP,0OB.FH,OB.MH,OB.FL 


0 ;Object type value 
1 ;Object type unit number 
B.OT+2 ;Offset to remote connect # 
B.RN+4 ;Offset to remote process name [RAD50] 
B.RP+4 ;Offset to remote UIC [.WORD 
; GROUP ,USER] 
B.RU+4 ;Offset to # of user arguements 
B.NA+2 ;Offset to first user arguement 
B.UA :Minimum size of buffer [0 arguements] 
B.MN+10 ;Maximum size of buffer [8. arguments] 
10 ?Send this message at AST level [XMIT] 
1 ;No status message required [RECV] 
2 ;Connect reject [remote user 


; rejection] 
;Connect reject [remote NCS rejection] 
;Maximum reason 
;Reject by NCS 
;Tco many connects to remote node 
;Too many connects to remote process 
;Process does not exist on this node 
;Object type does not exist on this 
; node 
;Destination address in use 
;Nede shutting down 


HP Onan 


oil 
rrr. 
Wh 


;Invalid task name 
s;Invalid qualifier 

;Bad destination parameter 
;Disconnect initiate 
;Disconnect terminate [CONFIRM] 
s;Disconnect abort 
; Loopback normal 

;Loopback echo mode 

0 :Connect initiate 

1 sConnect confirm 
= -5 ;Disconnect abort [partner terminated] 


aU & 
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IA.DIS = -7 


IA.NFW = 177673 


IA.ISM = 1 
CN.IN = 1 
CN.OU = 2 
CN.UT = 4 
CN.NT = 10 
OB.TA = 0 
OB.FS = 1 
OB.SQ = 2 
OB.BO = 3 
OB.TC = 4 
OB.RD = 5 
OB.RA = 6 
OB.ND = 7 
OB.DD = 10 
OB.BM = ll 
712-17 RESERVED 
OB.TH = 20 
OB.TB = 21 
OB.TI = 22 
OB.CR = 23 
OB.LP = 24 
OB.PR = 25 
OB.PP = 26 
OB.PL = 27 
OB.MT = 30 
OB.DT = 31 
OB.CS = 32 
OB.CP = 33 
OB.FH = 34 
OB.MH = 35 
OB.FL = 36 


~-MACRO COMDFS A 
-ENDM 

-LIST 

.ENDM 

- END 


MACRO EXPANSIONS 


;Disconnect requested [partner did 

+ disc QIO] 

;Topology change -- partner no longer 
; reachable 

jInterrupt semaphore from partner 

;If set: inhibit incoming connections 
;If set: inhibit outgoing connections 
;1f set: user tap 

7I£ set: NCL tap 

;Task 

;File system [dap] 

;Sequential devices [DAP] 

;Boot task 

7Terminal control task 

;Remote directives 

;Resource allocater 

;Network directory service 

;DDCMP link 

;Boot message link 


;Terminal handler 
Terminal : block mode 
;Terminal : interactive 
;Card reader 

;Line printer 

;PAPER TAPE READER 
;Paper tape punch 
;Plotter 3 
;Magnetic tape 
;DECTAPE 

;Cassette 

;Card punch 

;Fixed head disk 
;Moving head disk 
;Ploppy disk 


C.7 PROGRAM LOGICAL ADDRESS SPACE EXTENSION MACRO EXPANSIONS 


C.7.1 ATRGS, ATRGSC, 


and ATRGSS Macros 


These macros generate the code to attach a region. 


-MACRO ATRGS RDB 
.MCALL OFFS 
-IF NDF $SSGLB 
.BYTE 57.,2 
-WORD RDB 
.ENDC 

-IF NDF A.TRBA 
OFFS 

OFFS A.TRBA,2 
. ENDC \ 
-ENDM ATRGS$ 
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«MACRO ATRGSC RDB,CS,ERR 
-MCALL ATRGS ,DIRS 
-IF NDF $S$SGLB 
-PSECT S$DPBSS 
$$$. 
~IFTF 
ATRGS$ RDB 
IFT 
.PSECT CS 
DIRS #$$$,ERR 
~ENDC 
~ENDM ATRGSC 


»~MACRO ATRGSS RDB,ERR 
-MCALL DIRS ,MOV$ 

MOVS RDB 

MOV (PC) +,-(SP) 

~-BYTE 57.,2 

DIR$ ,ERR 

~ENDM ATRGSS 


C.7.2 .BLK., .BLKB., and .BILKW. Macros 


These macros define the block offset symbol. The 
Address Space definition macros use these macros. 


-MACRO .BLKB. NUM,SYM,GBL 
.IF NB <SYM> 
»IF IDN <DEFSG>,<GBL> 
SYM==S$$ 
~IFF 
SYM=SS$ 
~ENDC 
~ENDC 
$$$=SSS+NUM 
-ENDM .BLKB. 
»MACRO .BLKW. NUM,SYM,GBL 
.IF NB <SYM> 
.IF IDN <DEFSG>,<GBL> 
SYM==S$$ 
.IFF 
SYM=SSS$ 
.» ENDC 
~ENDC 
$$$=S$SS+<2*NUM> 
.ENDM .BLKW. 


-MACRO .BLK. 
$$$=0 
-ENDM .BLK. 


C.7.3 CRAWS, CRAWSC, CRAWSS Macro 


Program 


These macros generate the code to create an address window. 


»-MACRO CRAWS WDB 
~MCALL OFFS 

-IF NDF $$SGLB 
-BYTE 117.,2 
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-WORD WDB 
~ENDC 

-IF NDF C.RABA 
OFFS 

OFFS C.RABA,2 
~ENDC 

-ENDM CRAWS 


»-MACRO CRAWSC WDB,CS,ERR 

.MCALL CRAWS ,DIRS$ 

-IF NDF $SSGLB 

-PSECT SDPBS$ 
$S$$=, 

~IFTF 

CRAWS WDB 

IFT 

-PSECT CS 

DIRS #$$$,ERR 

.ENDC 

-ENDM CRAWSC 


»MACRO CRAWSS WDB,ERR 
»MCALL DIRS ,MOVS 

MOVS WDB 

BYTE 117.,2 

DIRS ,ERR 

~ENDM CRAWSS 


C.7.4 CRRG$, CRRGSC, and CRRGSS Macros 
These macros generate the code to create a region. 


-MACRO CRRGS$ RDB 
»MCALL OFFS 
-IF NDF S$SSGLB 
-BYTE 55.,2 
-WORD RDB 
»ENDC 

~IF NDF C.RRBA 
OFFS 

OFFS C.RRBA,2 
»ENDC 

~ENDM CRRGS 


»MACRO CRRGSC RDB,CS,ERR 

-MCALL CRRGS ,DIRS 

~-IF NDF $SSGLB 

»-PSECT $DPBS$ 
$$S=, 

~IFTF 

CRRGS$ RDB 

~IFT 

-PSECT CS 

DIRS #$$S,ERR 

.ENDC 

-ENDM CRRGSC 


»MACRO CRRGSS RDB,ERR 
-MCALL DIRS ,MOVS 

MOVS RDB 

MOV (PC)+,-(SP) 
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~-BYTE 55.,2 
DIRS ,ERR 
-ENDM CRRGS$S 


C.7.5 DTRGS$, DTRGSC, and DIRGSS Macros 
These macros generate the code to detach a region. 


.MACRO DTRGS RDB 
-MCALL OFFS 
-IF NDF $SSGLB 
-BYTE 59.,2 
-WORD RDB 
.~ENDC 

.IF NDF D.TRBA 
OFFS 

OFFS D.TRBA,2 
~ENDC 

»ENDM DTRGS 


-MACRO DTRGSC RDB,CS,ERR 

-MCALL DTRGS ,DIRS 

-IF NDF $SSGLB 

-PSECT SDPBSS$ 
$$$=. 

~IFTF 

DTRG$ RDB 

IFT 

-PSECT CS 

DIRS #$$$,ERR 

-ENDC 

-ENDM DTRGSC 


-MACRO DTRGSS RDB,ERR 
-MCALL DIRS ,MOV$ 

MOVS RDB 

MOV (PC)+,-(SP) 

~-BYTE 59.,2 

DIRS ,ERR 

~-ENDM DTRGSS 


C.7.6 ELAWS, ELAWSC, and ELAWSS Macros 
These macros generate the code to eliminate an address window. 
-MACRO ELAWS WDB 


-MCALL OFFS 
-IF NDF $SSGLB 


sBY TE: 129.552 
»WORD WDB 
-ENDC 

-IF NDF E.LABA 
OFFS 

OFFS E.LABA,2 
»ENDC 


»~ENDM ELAWS 


-MACRO ELAWSC WDB,CS,ERR 
»MCALL ELAWS ,DIRS 
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-IF NDF $S$$GLB 

»PSECT SDPBS$$ 
$$$=., 

~IPTF 

ELAWS WDB 

IFT 

-PSECT CS 

DIRS #$5$,ERR 

.ENDC 

-ENDM ELAWSC 


-MACRO ELAWSS WDB,ERR 
-MCALL DIRS ,MOVS 

MOV$ WDB 

MOV (PC)+,-(SP) 

«BYTE 119.52 

DIR$ ,ERR 

-ENDM ELAWSS 


C.7.7 GMCX$, GMCX$C, and GMCX$S Macros 
The macros generate the code to get the mapping context. 


-MACRO GMCXS$ WVEC 

-MCALL OFFS 

.IF NDF SSSGLB 

BYTE 213.652 

»WORD WVEC 

- ENDC 

.IF NDF G.MCVA 

OFFS 

OFFS G.MCVA,2 

- ENDC 

~ENDM GMCXS 

~MACRO GMCXSC WVEC,CS,ERR 

-MCALL GMCXS ,DIRS$ 

.IF NDF $SSGLB 

»-PSECT SDPBS$ 
$$$=s, 

~IFTF 

GMCX$ WVEC 

.IFT 

-PSECT CS 

DIRS #$$$,ERR 

-ENDC 

~ENDM GMCXSC 

»~MACRO GMCX$S WVEC,ERR 

-MCALL DIRS ,MOVS 

MOVS WVEC 

MOV (PC)+,~-(SP) 

~-BYTE 113.,2 

DIRS ,ERR 

-ENDM GMCXS$S 


C.7.8 GREGS$, GREGSC, and GREGSS Macros 


These macros get region parameters, They are a special case of the 
get partition parameters macros. 
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»MACRO GREGS$ RID,BUF 
»MCALL OFFS 
-IF NDF $SSGLB 
-BYTE 65.,4 
-WORD 0,RID 
~WORD BUF 
~ENDC 
.IF NDF G.RGID 
-NLIST 
OFFS 
OFFS ,2 
OFFS G.RGID,2 
OFFS G.RGBA,2 
.IF NDF G.RGRB 
$$SOST=0 
~IRP X,<<G.RGRB,2>,<G.RGRS ,2> ,<G.RGFW, 2>> 
OFFS X 
-ENDM 
~ENDC 
-LIST 
~ENDC 
~ENDM GREGS 
»-MACRO GREGSC RID,BUF,CS,ERR 
.MCALL GREGS$ ,DIRS 
-IF NDF SSSGLB 
»PSECT S$DPBSS$ 
$$$=. 
~IFTF 
GREGS RID,BUF 
IFT 
.PSECT CS 
DIRS #$$$,ERR 
»ENDC 
»ENDM GREGSC 
-MACRO GREGSS RID,BUF,ERR 
-MCALL MOVS ,DIRS ,OFFS$ 
MOVS BUF 
MOVS RID 
CLR -(SP) 
MOV (PC) +,-(SP) 
-BYTE 65.,4 
DIRS ,ERR 
.IF NDF G.RGRB 
»NLIST 
$$SosT=0 
-IRP X,<<G.RGRB,2>,<G.RGRS,2>,<G.RGFW,2>> 
OFFS X 
~ENDM 
-LIST 
~ENDC 
-ENDM GREGSS 


C.7.9 MAPS, MAPSC, MAPSS Macros 


These macros generate the code to map an address window. 


.MACRO MAPS WDB 
-MCALL OFFS 

-IF NDF $S$S$GLB 
-BYTE 121.,2 
»WORD WDB 

»ENDC 
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-IF NDF M.APBA 
OFFS 

OFFS M.APBA,2 
~ENDC 

-ENDM MAPS 


«MACRO MAPSC WDB,CS,ERR 

»MCALL. MAPS ,DIRS 

~IF NDF SSSGLB 

-PSECT SDPBSS$ 
$$$=. 

~IFTFE 

MAPS WDB 

~IFT 

-PSECT CS 

DIRS #$$$,ERR 

-ENDC 

-ENDM MAPSC 


-MACRO MAPSS WDB,ERR 
-MCALL DIRS ,MOVS 
MOVS WDB 

MOV (PC)+,-(SP) 
~-BYTE 121.,2 

DIRS ,ERR 

-ENDM MAPSS 


C.7.10 RDBBKS Macro 
RDBBKS generates a region definition block. 


-MACRO RDBBKS S1IZ,NAM,PAR,STS,PRO 
-MCALL RDBDFS ,R50$ 


RDBDFS$ ;Define region definition block 
3; symbols 
eWORD 0 ;Region ID 
»~WORD SIZ :Size of region (32w blocks) 
R50S NAM ;Name of region (RAD50) 
R50$ PAR ;Region's main partition name (RAD50) 
-WORD STS *Region status word 
»~WORD PRO :Region protection word 


-ENDM RDBBKS 


C.7.11 RREF$, RREFSC, and RREFS$S Macros 
These macros generate the code to receive by reference. 


-MACRO RREFS WDB 
-MCALL OFFS 
-IF NDF $$$GLB 
~-BYTE 81.,2 
.WORD WDB 
-ENDC 

-IF NDF R.REBA 
OFFS 

OFFS R.REBA,2 
~ENDC 

~ENDM RREFS 
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-MACRO RREFSC WDB,CS,ERR 

.MCALL RREFS ,DIRS 

~IF NDF SSSGLB 

»PSECT SDPBSS 
$$S=, 

~IFTF 

RREFS WDB 

IFT 

-PSECT CS 

DIRS #$$$,ERR 

-ENDC 

»ENDM RREFSC 


-MACRO RREFSS WDB,ERR 
-MCALL DIRS ,MOVS 

MOV$ WDB 

MOV (PC) +,-(SP) 

-BYTE 81.,2 

DIRS ,ERR 

~ENDM RREFSS 


C.7.12 SREFS, SREFSC, and SREF$S Macros 
These macros generate the code to send by reference. 


.MACRO SREFS TASK,WDB,EFN 
-MCALL R50S ,OFFS 
-IF NDF S$S$SGLB 
-BYTE 69.,5 
R50$ TASK 
.WORD EFN 
-WORD WDB 
»ENDC 
.IF NDF S.RETN 
-IRP X,<,<S.RETN,4>,<S.REEF,2>,<S.REBA,2>> 
OFFS X 
.ENDM 
-ENDC 
-ENDM SREFS 
-MACRO SREFSC TASK,WDB,EFN,CS,ERR 
-MCALL SREFS ,DIRS 
-IF NDF $SSGLB 
-PSECT SDPBS$ 


$$S=, 
~IFTF 
SREFS TASK,WDB,EFN 
IFT 
-PSECT CS 
DIRS #$$$,ERR 
.ENDC 


~-ENDM SREFSC 


-MACRO SREFSS TSKADR,WDB,EFN,ERR 
-MCALL DIRS ,MOVS ,RFAS 

MOVS$ WDB 

MOVS EFN 

RFAS TSKADR 

MOV (PC)+,-(SP) 

-BYTE 69.,5 

DIRS ,ERR 

«ENDM SREFSS 
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SRRAS, SRRASC, and SRRASS Macros 


These macros generate the code for the SPECIFY RECEIVE BY 
AST directive. 


$$$. 
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»MACRO SRRAS AST 
-MCALL OFFS 
-IF NDF S$SSGLB 
~BYTE 21.,2 
.WORD AST 
~ENDC 

-IF NDF S.RRAE 
»NLIST 

OFFS 

OFFS S.RRAE,2 
-LIST 

»ENDC 

-ENDM SRRAS 


.-MACRO SRRASC AST,CS,ERR 
-MCALL SRRAS ,DIRS$ 

-IF NDF SSSGLB 

-PSECT SDPBS$ 


.IFTF 

SRRA$ AST 

ck PT 

-PSECT CS 
DIRS #$$$,ERR 
- ENDC 


~ENDM SRRASC 

«MACRO SRRASS AST,ERR 
-MCALL MOVS ,DIRS 

MOVS AST 

MOV (PC)+,-(SP) 

sEYTE 21442 

DIRS ,ERR 

-ENDM SRRASS 


UMAP$, UMAPSC, and UMAPSS Macros 


These macros generate the code to unmap an address window. 


$$$=. 


»~MACRO UMAPS WDB 
»MCALL OFFS 
~IF NDF SSSGLB 
~BYTE 123.,2 
»WORD WDB 
»ENDC 

-IF NDF U.MABA 
OFFS 

OFFS U.MABA,2 
.» ENDC 

»ENDM UMAPS 


»-MACRO UMAPSC WDB,CS,ERR 
.MCALL UMAPS ,DIRS 

.IF NDF $S$SGLB 

»-PSECT S$DPBS$ 


-IFTF 
UMAPS WDB 
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IFT 
-PSECT CS 
DIRS #$$$,ERR 
~ENDC 

-ENDM UMAPSC 
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-MACRO UMAPSS WDB,ERR 


-MCALL DIRS ,MOV$ 


MOVS WDB 

MOV (PC)+,-(SP) 
-BYTE 123.,2 
DIR$ ,ERR 
-ENDM UMAPSS 


C.7.15 WDBBKS Macro 


WDBBKS generates a window definition block. 


-MACRO WDBBKS APR,SIZ,RID,OFF,LEN,STS,SRB 


-MCALL WDBDFS$ 
WDBDFS 


-BYTE 0,APR 
-WORD 0 
~WORD SIZ 
«WORD RID 
-WORD OFF 
-WORD LEN 
eWORD STS 
»WORD SRB 


-ENDM WDBBKS 


sDefine window definition block 


; symbols 
;Window ID / base APR. 
;Virtual base address (bytes) 
;Window size (32w blocks) 
;Region ID 
;Offset in partition (32w blocks) 
;Length to map (32w blocks) 
;Status word 
:;Send/receive buffer virtual address 


C.8 RELATIVE FILES MACROS - EXPANSIONS 


C.8.1 RCLOS$ Macro 
RCLOSS closes a file. 


.MACRO RCLOSS FDB,ERR 
»MCALL LDFDBS ,ERR$ 
LDFDBS FDB 

JSR PC,.RCLOS 

ERRS ERR 

-ENDM RCLOSS 


C.8.2 RFDBTS$ Macro 


RFDBT$ defines the relative file descriptor bits. 


-MACRO RFDBTS$ GLOBL 
~-MCALL DEFINS 
-- -GBL=0 


-IIF IDN,<GLOBL>,<DEFSG>, 


oe -GBL=1 
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Relative File Flags Byte 


DEFINS RF.WRT,1 ;Set if bit table record 

; buffer dirty 
DEFINS RF.EXT,2 ;Set if extend is allowed 
DEFINS RF.BEX,4 ;Set if extend attempted when 


; restricted 
Relative File Value Byte 


DEFINS RB.NEW,1 ;New bit value to set 
DEFINS RB.NCH,2 zl if not changing value 
DEFINS RB.VAL,4 ;Bit value read 


.MACRO RFDBTS ARG 
~-ENDM RFDBTS 
.ENDM RFDBTS 


C.8.3 RFINDS Macro 
RFINDS finds the next existing record. 


.MACRO RFINDS FDB,LRCNM,HRCNM,ERR 
-MCALL LDFDBS ,CMOVSW,ERRS 

LDFDBS FDB 

CMOVSW LRCNM,R.RCNM+2 

CMOVSW HRCNM,R.RCNM 

JSR PC,.RFIND 

ERRS ERR 

»-ENDM RFINDS 


C.8.4 RFOFSL Macro 

RFOFSL locally defines relative file record offsets. 
»MACRO RFOFSL 
»~MCALL RFOFFS 


RFOFF$ DEFSL 
-ENDM RFOFSL 


C.8.5 RFOFFS Macro 
RFOFFS defines the offsets for the relative file extension of the FDB. 
».MACRO RFOFFS OFFSET 
-MCALL OFFSET,DEFSI,FDBS2Z$ 
FDBSZ$ 
DEFSI S.FDB 


Relative File Record Section 


OFFSET R.RCNM,4 ;Relative record number 
OFFSET R.CLSZ,4 Cluster size 

OFFSET R.FLAG,1 ;Flags byte 

OFFSET R.BTVL,1l ;Value byte 

OFFSET R.BTSZ,2 ; ;Bit table record size 
OFFSET R.BTBF,2 *;Bit table record buffer 
OFFSET R.BTIN,2 ;Bit table number 

OFFSET R.BTRC,2 ;Bit table record number 
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OFFSET S.RFD :Size of RFDB 
~IIF IDN,<DEFSN>,<OFFSET>, .MEXIT 
-MACRO RFOFFS ARG 

~ENDM RFOFFS 

-ENDM RFOFFS 


C.8.6 RGET$ Macro 
RGETS gets a relative file. 


.MACRO RGETS FDB,INADR,MAXCNT,LRCNM,HRCNM,ERR 
-MCALL LDFDBS ,CMOVSW,ERRS 

LDFDBS$ FDB 

CMOVSW INADR,F.URBD+2 

CMOVSW MAXCNT,F.URBD 

CMOVSW LRCNM,R.RCNM+2 

CMOVSW HRCNM,R.RCNM 

JSR PC,.RGET 

ERRS$ ERR 

.ENDM RGETS 


C.8.7 ROPNS Macro 
ROPNS opens a file. 


»MACRO ROPNS FDB,FACC,LUN,FNPT,DFNB, RACC,URBA,URBS,ERR 
-MCALL FDOPSR,FDRCSR,ERR$ ,CMOVSB 

FDOPSR FDB,LUN,FNPT,DFNB, FACC 

FDRCSR ,RACC,URBA,URBS 

-GLOBL .ROPEN 

JSR PC,.ROPEN 

ERR$ ERR 

-ENDM ROPNS 


C.8.8 ROPNSA Macro 
ROPNSA opens a file for appending. 
«MACRO ROPNSA FDB,LUN,FNPT,RACC,URBA,URBS,ERR 


~-MCALL ROPNS 


ROPNS FDB,#FO.APD,LUN,FNPT,,RACC,URBA,URBS,ERR 
»-ENDM ROPNSA 


C.8.9 ROPNSM Macro 
ROPNSM opens a file for modification. 
»MACRO ROPNSM FDB,LUN,FNPT,RACC,URBA,URBS,ERR 


-MCALL ROPNS 


ROPNS FDB,#FO.MFY,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM ROPNSM 
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C.8.10 ROPNSR Macro 

ROPNSR opens a file for reading. 
-MACRO ROPNSR FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
»~MCALL ROPNS 


ROPNS FDB,#FO.RD,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM ROPNSR 


C.8.11 ROPNSU Macro 

ROPNSU opens a file for updating. 
~MACRO ROPNSU FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
»MCALL ROPNS 


ROPNS FDB,#FO.UPD,LUN,FNPT,,RACC,URBA,URBS,ERR 
«ENDM ROPNSU 


C.8.12 ROPNSW Macro 

ROPNSW opens a file for writing. 
»-MACRO ROPNSW FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
»~MCALL ROPNS ee 


ROPNS FDB,#FO.WRT,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM ROPNSW 


C.8.13 ROPSSA Macro 
ROPSSA opens a shared file for appending. 
-MACRO ROPSSA FDB,LUN,FNPT,RACC,URBA,URBS,ERR 


»~MCALL ROPNS 
ROPNS FDB,#FA.SHR!FO.APD,LUN,FNPT,,RACC,URBA,URBS,ERR 


-ENDM ROPSSA 


C.8.14 ROPSSM Macro 
ROPS$M opens a shared file for modification. 
»MACRO ROPSSM FDB,LUN,FNPT,RACC,URBA,URBS,ERR 


-MCALL ROPNS 
ROPNS FDB,#FA.SHR!FO.MFPY,LUN,FNPT,,RACC,URBA,URBS,ERR 


-ENDM ROPSSM 


C.8.15 ROPSSR Macro 

ROPSSR opens a shared file for reading. 
»-MACRO ROPSSR FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL ROPNS 


ROPNS FDB,#FA.SHR!FO.RD,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM ROPSSR 


C=113 


MACRO EXPANSIONS 


C.8.16 ROPSSU Macro 
ROPSSU opens a shared file for updating. 


-MACRO ROPSSU FDB,LUN,FNPT,RACC,URBA,URBS,ERR 

~MCALL ROPNS 

ROPNS FDB,#FA.SHR!FO.UPD,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM ROPSSU 


C.8.17 ROPSSW Macro 
ROPSSW opens a Shared file for writing. 


-MACRO ROPSSW FDB,LUN,FNPT,RACC,URBA,URBS,ERR 

-MCALL ROPNS 

ROPNS FDB,#FA.SHR!FO.WRT,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM ROPSSW 


C.8.18 RPORTS Macro 
RPORTS reports the existence of a record for a relative file. 


-MACRO RPORTS FDB,LRCNM,HRCNM,ERR 
-MCALL RPRTCS ; 
RPRTCS <FDB>,#-1,<LRCNM> ,<HRCNM> ,<ERR> 
-ENDM RPORTS 


C.8.19 RPRTCS Macro 
RPRTCS$ reports on and optionally changes the existence of a record. 


-MACRO RPRTCS FDB,CHGVAL,LRCNM,HRCNM,ERR 
-MCALL LDFDBS ,CMOVSW,CMOV3B,ERRS$ 

LDFDBS$ FDB 

CMOVSB CHGVAL,R.BTVL 

CMOVSW LRCNM,R.RCNM+2 

CMOVSW HRCNM,R.RCNM 

JSR PC,.RPRTC 

ERR$ ERR 

-ENDM RPRTCS 


C.8.20 RPUTS Macro 
RPUTS puts a relative file. 


~MACRO RPUTS FDB,OUTADR,OUTCNT,LRCNM,HRCNM,ERR 
-MCALL LDFDBS ,CMOVSW,ERRS 

LDFDB3 FDB 

CMOVSW OUTADR,F.NRBD+2 

CMOVSW OUTCNT,F.NRBD 

CMOVSW LRCNM,R.RCNM+2 

CMOVSW HRCNM,R.RCNM 

JSR PC,.RPUT 

ERRS$ ERR 

-ENDM RPUTS 
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C.9 QIOMAC - QIOSYM MACRO DEFINITIONS 


C.9.1 DRERRS Macro 


Defines the directive error codes returned in the directive status 
word, File control services (FCS) returns these codes in the F.ERR 
byte of the File Descriptor Block (FDB). To distinguish them from the 
overlapping codes from handler and file primitives, the F.ERR+1 byte 
in the FDB is negative for a directive error code. 


-MACRO DRERRS SSSGBL 
-MCALL .QIOE.,DEFINS 

-IF IDN,<SSSGBL> ,<DEFSG> 
-. GBL=1 

-IFF 

.. GBL=0 

»ENDC 

-LIF NDF,SSMSG,SSMSG=0 


Standard Error Codes Returned by Directives in the Directive Status 
Word 


-QIOE. IE.UPN,-01.,<INSUFFICIENT DYNAMIC STORAGE> 

-QIOE. IE.INS,-02.,<SPECIFIED TASK NOT INSTALLED> 

-QIOE. IE.PTS,-03.,<PARTITION TOO SMALL FOR TASK> 

-QIOE. IE.UNS,-04.,<INSUFFICIENT DYNAMIC STORAGE FOR SEND> 
-QIOE. ITE.ULN,-05.,<UN-ASSIGNED LUN> 

-QIOE. IE.HWR,-06.,<DEVICE HANDLER NOT RESIDENT> 

-QIOE. IE.ACT,-07.,<TASK NOT ACTIVE> 

-QIOE. IE.ITS,-08.,<DIRECTIVE INCONSISTENT WITH TASK STATE> 
-QIOE. IE.FIX,-09.,<TASK ALREADY FIXED/UNFIXED> 

-QIOE. IE.CKP,-10.,<ISSUING TASK NOT CHECKPOINTABLE> 
-QIOE. IE.TCH,-11.,<TASK IS CHECKPOINTABLE> 

-QIOE. IE.RBS,-15.,<RECEIVE BUFFER IS TOO SMALL> 

-QIOE. IE.PRI,-16.,<PRIVILEGE VIOLATION> 

-QIOE. IE.RSU,-17.,<RESOURCE IN USE> 

-QIOE. IE.NSW,-18.,<NO SWAP SPACE AVAILABLE> 

-QIOE. IE.ILV,-19.,<ILLEGAL VECTOR SPECIFIED> 

-QIOE. IE.AST,-80.,<DIRECTIVE ISSUED/NOT ISSUED FROM AST> 
-QIOE. IE.MAP,-81.,<ILLEGAL MAPPING SPECIFIED> 

-QIOE. IE.IOP,-83.,<WINDOW HAS I/O IN PROGRESS> 

-QIOE. IE.ALG,-84.,<ALIGNMENT ERROR> 

-QIOE. IE.WOV,-85.,<ADDRESS WINDOW ALLOCATION OVERFLOW> 
-QIOE. IE.NVR,-86.,<INVALID REGION ID> 

-QIOE. IE.NVW,-87.,<INVALID ADDRESS WINDOW ID> 

-QIOE. IE.ITP,-88.,<INVALID TI PARAMETER> 

-QIOE. IE.IBS,-89.,<INVALID SEND BUFFER SIZE ( .GT. 255.)> 
-QIOE. IE.LNL,-~90.,<LUN LOCKED IN USE> 

-QIOE. IE.IUI,-91.,<INVALID UIC> 

-QIOE. IE.IDU,-92.,<INVALID DEVICE OR UNIT> 

-QIOE. IE.ITI,-93.,<INVALID TIME PARAMETERS> 

-QIOE. IE.PNS,-94.,<PARTITION/REGION NOT IN SYSTEM> 
-QIOE. IE.IPR,-95.,<INVALID PRIORITY ( .GT. 250.)> 

-QIOE. IE.ILU,-96.,<INVALID LUN> 

-QIOE. IE.IEF,-97.,<INVALID EVENT FLAG ( .GT. 64.)> 
-QIOE. IE.ADP,-98.,<PART OF DPB OUT OF USER'S SPACE> 
-QIOE. IE.SDP,-99.,<DIC OR DPB SIZE INVALID> 
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Success Codes from Directives - Placed in the Directive Status Word 


DEFINS IS.CLR,O ;Event flag was clear 

; from CLEAR EVENT FLAG. directive 
DEFINS IS.SET,2 ;Event flag was set 

; from SET EVENT FLAG directive 
DEFINS IS.SPD,2 Task was suspended 


~-IF EQ,S$SMSG 
~MACRO DRERRS A 
-ENDM DRERRS 


« ENDC 


-ENDM DRERRS 


C.9.2 FILIOS Macro 


FILIOS defines 


the 


independent. 


.MACRO FILIOS SSSGBL 


.MCALL 
-IF IDN,<S$SSGBL>,<DEFSG> 


-WORD.,DEFINS 


se .GBL=1 


~IFF 


-- -GBL=0 


general QIO 


function codes that are device 


General QIO Qualifier Byte Definitions 


~WORD. IQ.X,001,000 ;No error recovery 

»-WORD. I10.Q,002,000 ;Queue request in express queue 
-WORD. I10.S,004,000 ;Synonym for IQ.UMD 

-WORD. IQ.UMD,004,000 :User mode diagnostic status required 


Express Queue Commands 


WORD. IO.KIL,012,000 Kill current request 

~WORD. IO.RDN,022,000 3;I/O rundown 

-WORD. IO.UNL,042,000 ;Unload I/O handler task 
»~WORD. IO.LTK,050,000 ;Load a task image file 
-WORD. IO.RTK,060 ,000 ;Record a task image file 
WORD. IO.SET,030,000 Set characteristics function 


General Device Handler Codes 


-WORD. IO.WLB,000,001 ;Write logical block 

»~WORD. IO.RLB,000,002 ;Read logical block 

~-WORD. I0.LOV,010 ,002 ;Load overlay (disk driver) 
»~WORD. IO.ATT,000 ,003 ;Attach a device to a task 
»~WORD. IO.DET,000,004 ;Detach a device from a task 


Directory Primitive Codes 


~-WORD. IO.FNA,000,011 ;Find file name in directory 
»~WORD. IO.RNA,000 ,013 ;Remove file name from directory 
~-WORD. IO.ENA,000,014 ;Enter file name in directory 


File Primitive Codes 


-WORD. I0.CLN,000,007 :;Close out LUN 
WORD. IO.ULK,000,012 ;Unlock block 
-WORD. IO.ACR,000,015 ;Access for read 
~-WORD. IO.ACW,000,016 ;Access for write 
-WORD. IO.ACE,000,017 7;Access for extend 
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»~WORD. I0.DAC,000,020 ;De-access file 

WORD. IO.RVB,000,021 Read viritual block 
»WORD. IO.WVB,000,022 y;Write virtual block 
«WORD. IO.EXT,000,023 ;Extend file 

»~WORD. IO.CRE,000,024 ;Create file 

eWORD. IO.DEL,000,025 ;Delete file 

-WORD. IO.RAT,000 ,026 ;Read file attributes 
»~WORD. IO.WAT,000 ,027 sWrite file attributes 
e-WORD. IO.APV,010 ,030 ;Privileged ACP control 
~WORD. IO.APC,000,030 ;ACP control 

»-MACRO FILIOS A 

»~ENDM FILIOS 

-ENDM FILIOS 


C.9.3 .IOER. Macro 


This macro defines handler error codes that are returned in the I/O 
status block are defined through this macro. This macro then 
conditionally invokes the message generating macro for the QIOSYM.MSG 
file. 


-MACRO .IOER. SYM,LO,MSG 
DEFINS$S SYM,LO 

-IF GT,5$MSG 

»-MCALL .IOMG. 

-IOMG. SYM,LO,<MSG> 

» ENDC 

~-ENDM .IOER. 


C.9.4 IOERRS Macro 


This macro defines the error codes returned by device handlers and 
file primitives in the first word of the I/O status block. The File 
Control Services also return these codes in the F.ERR byte in the File 
Descriptor Block (FDB). The F.ERR+1 byte is 0 if F.ERR contains a 
handler or FCP error code. 


»-MACRO IOERRS SSS$GBL 
-MCALL .IOER.,DEFINS 

-IF IDN,<SS$SGBL> ,<DEF$G> 
~ «es GBL=1 

«LiF 

ee . ~GBL=0 

-ENDC 

-IIF NDF,$SMSG,SSMSG=0 


System standard codes, used by executive and drivers: 


-IOER. IE.BAD,~01.,<BAD PARAMETERS> 

~-IOER. IE.IFC,-02.,<INVALID FUNCTION CODE> 
-IOER. IE.DNR,-03.,<DEVICE NOT READY> 

~-IOER. IE.VER,-04.,<PARITY ERROR ON DEVICE> 
-IOER. IE.ONP,-05.,<HARDWARE OPTION NOT PRESENT> 
-IOER. IE.SPC,-06.,<ILLEGAL USER BUFFER> 

-IOER. IE.DNA,-07.,<DEVICE NOT ATTACHED> 

-IOER. IE.DAA,-08.,<DEVICE ALREADY ATTACHED> 
-IOER. IE.DUN,-09.,<DEVICE NOT ATTACHABLE> 
-IOER. IE.EOF,-10.,<END OF FILE DETECTED> 

»-IOER. IE.EOV,-11.,<END OF VOLUME DETECTED> 
~-IOER. IE.WLK,-12.,<WRITE ATTEMPTED TO LOCKED UNIT> 
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- IOER. 
-IOER. 
~-IOER. 
-IOER. 
-IOER. 
-IOER. 
~IOER. 
»IOER. 
-IOER. 
-IOER. 
-IOER. 
-IOER. 
-IOER. 
-IOER. 
-IOER. 
- IOER. 
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IE.DAO,-13.,<DATA OVERRUN> 
IE.SRE,-14.,<SEND/RECEIVE FAILURE> 
IE.ABO,-15.,<REQUEST TERMINATED> 
IE.PRI,-16.,<PRIVILEGE VIOLATION> 
IE.RSU,-17.,<SHARABLE RESOURCE IN USE> 
IE.OVR,-18.,<ILLEGAL OVERLAY REQUEST> 
IE.BYT,-19.,<ODD BYTE COUNT (OR VIRTUAL ADDRESS) > 
IE.BLK,-20.,<LOGICAL BLOCK NUMBER TOO LARGE> 
IE.MOD,-21.,<INVALID UDC MODULE #> 

IE.CON ,-22.,<UDC CONNECT ERROR> 

IE.BBE,-56.,<BAD BLOCK ON DEVICE> 
IE.STK,-58.,<NOT ENOUGH STACK SPACE (FCS OR FCP) > 
IE.FHE,-59.,<FATAL HARDWARE ERROR ON DEVICE> 
IE.EOT,-62.,<END OF TAPE DETECTED> 
IE.OFL,~65.,<DEVICE OFF LINE> 

IE.BCC,-66.,<BLOCK CHECK, CRC, OR FRAMING ERROR> 


File Primitive Codes 


-IOER. 
-IOER. 
-IOER. 
- IOER. 
- IOER. 
-IOER. 
~IOER. 
-IOER. 
-IOER. 
»IOER. 
»IOER. 
-IOER. 
-IOER. 
-IOER. 
-IOER. 
-IOER. 
-IOER. 
-IOER,. 
-IOER. 
»ITOER. 
-IOER. 
- IOER. 
-IOER. 
-IOER. 


IE.NOD,-23.,<CALLER'S NODES EXHAUSTED> 
IE.DFU,-24.,<DEVICE FULL> 

IE.IFU,-25.,<INDEX FILE FULL> 

IE.NSF,7~26.,<NO SUCH FILE> 

IE.LCK,-27.,<LOCKED FROM READ/WRITE ACCESS> 
IE.HFU,-28.,<FILE HEADER FULL> 
IE.WAC,-29.,<ACCESSED FOR WRITE> 
IE.CKS,-30.,<FILE HEADER CHECKSUM FAILURE> 
IE.WAT,-31.,<ATTRIBUTE CONTROL LIST FORMAT ERROR> 
IE.RER,~32.,<FILE PROCESSOR DEVICE READ ERROR> 
IE.WER,-33.,<FILE PROCESSOR DEVICE WRITE ERROR> 
IE.ALN,-34.,<FILE ALREADY ACCESSED ON LUN> 
IE.SNC,-35.,<FILE ID, FILE NUMBER CHECK> 
IE.SQC,-36.,<FILE ID, SEQUENCE NUMBER CHECK> 
IE.NLN,-37.,<NO FILE ACCESSED ON LUN> 
IE.CLO,-38.,<FILE WAS NOT PROPERLY CLOSED> 
IE.DUP,-57.,<ENTER ~- DUPLICATE ENTRY IN DIRECTORY> 
IE.BVR,-63.,<BAD VERSION NUMBER> 
IE.BHD,-64.,<BAD FILE HEADER> 

IE.EXP,~75.,<FILE EXPIRATION DATE NOT REACHED> 
IE.BTF,-76.,<BAD TAPE FORMAT> 
IE.ALC,~-84.,<ALLOCATION FAILURE> 
IE.ULK,-85.,<UNLOCK ERROR> 

IE.WCK,~86.,<WRITE CHECK FAILURE> 


File Control Services Codes 


-IOER. 
-IOER. 
-IOER. 
-IOER. 


-IOER. 
-IOER. 
- IOER. 
-IOER. 
-IOER. 
- IOER. 
-IOER. 
~IOER. 
-IOER. 
» IOER. 
-IOER. 
~IOER. 
-IOER. 


IE.NBF,-39.,<OPEN - NO BUFFER SPACE AVAILABLE FOR FILE> 

IE.RBG,-40.,<ILLEGAL RECORD SIZE> 

IE.NBK,-41.,<FILE EXCEEDS SPACE ALLOCATED, NO BLOCKS> 

IE.ILL,-42.,<ILLEGAL OPERATION ON FILE DESCRIPTOR 
BLOCK> 

IE.BTP,-43.,<BAD RECORD TYPE> 

IE.RAC,-44.,<IULEGAL RECORD ACCESS BITS SET> 

IE.RAT,-45.,<ILLEGAL RECORD ATTRIBUTES BITS SET> 

IE.RCN,-46.,<ILLEGAL RECORD NUMBER - TOO LARGE> 

IE.2DV,-48.,<RENAME - 2 DIFFERENT DEVICES> 

IE.FEX,-49.,<RENAME - NEW FILE NAME ALREADY IN USE> 

IE.BDR,-50.,<BAD DIRECTORY FILE> 

IE.RNM,-51.,<CANNOT RENAME OLD FILE SYSTEM> 

IE.BDI,-52.,<BAD DIRECTORY SYNTAX> 

IE.FOP,-53.,<FILE ALREADY OPEN> 

IE.BNM,-54.,<BAD FILE NAME> 

IE.BDV,-55.,<BAD DEVICE NAME> 

IE.NFI,-60.,<FILE ID WAS NOT SPECIFIED> 
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-IOER. IE.1SQ,-61.,<ILLEGAL SEQUENTIAL OPERATION> 
-IOER. IE.NNC,-77.,<NOT ANSI ‘'D' FORMAT BYTE COUNT> 


Network ACP Codes 


-IOER. IE.AST,-80.,<NO AST SPECIFIED IN CONNECT> 

-LOER. IE.NNN,-68.,<NO SUCH NODED>D 

-IOER. IE.NFW,-69.,<PATH LOST TO PARTNER> ;This code must be 
3; odd 

-IOER. IE.BLB,-70.,<BAD LOGICAL BUFFER> 

-IOER. IE.TMM,-71.,<TOO MANY OUTSTANDING MESSAGES> 

~IOER. IE.NDR,-72.,<NO DYNAMIC SPACE AVAILABLE> 

~-IOER. IE.CNR,-73.,<CONNECTION REJECTED> 

~LOER. IE.TMO,-74.,<TIMEOUT ON REQUEST> 

~-IOER. IE.NNL,-78.,<NOT A NETWORK LUN> 


ICS/ICR Error Codes 


-IOER. IE.NLK,~79.,<TASK NOT LINKED TO SPECIFIED ICS/ICR 
INTERRUPTS > 

~IOER. IE.NST,-80.,<SPECIFIED TASK NOT INSTALLED> 

~-IOER. IE.FLN,-81.,<DEVICE OFFLINE WHEN OFFLINE REQUEST WAS 
ISSUED> 


TTY Error Codes 


-IOER. IE.IES,-82.,<INVALID ESCAPE SEQUENCE> 
-IOER. IE.PES,~83.,<PARTIAL ESCAPE SEQUENCE> 


Successful Return Codes: 


DEFINS IS.PND,+00. ;Operation pending 

DEFINS IS.SUC,+01. ;Operation complete, success 
DEFINS IS.RDD,+02. (RX11) Floppy disk successful 
completion of a read physical 
and a deleted data mark was 

seen in the sector header of 

the last sector. 

(A/D READ) At least one bad value 
was read (remainder may be good); 
bad channel is indicated by a 
negative value in the buffer. 


DEFINS IS.BV,+05. 


=e se “se “8 we NO wD NO MO 


TTY Success Codes 


DEFINS IS.CR,<15*400+1> ;Carriage return was terminator 
DEFINS IS.ESC,<33*400+1> ;Escape (ALTMODE) was terminator 
DEFINS IS.CC,<3*400+1> sCONTROL-C was terminator 


DEFINS IS.ESQ,<233*400+1> ;Escape sequence was terminator 
DEFINS IS.PES,<200*400+1> ;Partial escape sequence terminator 


DEFINS IS.EOT,<4*400+1> *EOT was terminator (block mode 
; input) 

DEFINS IS.TAB,<11*400+1> 7TAB was terminator (forms mode 
; input) 

DEFINS IS.TMO,+2. ;Request timed out 


-IF EQ,SSMSG 
-MACRO IOERRS A 
-ENDM IOERRS$ 
»ENDC 

-ENDM IOERRS 
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C.9.5 .QIOE. Macro 


This macro defines the QIO error codes. This macro then invokes 
error message generating macro, ".IOMG.". The QIOSYM.MSG file uses 


error codes -129 through -256. 


»-MACRO .QIOE. SYM,LO,MSG 
DEFINS SYM,LO 

-IF GT,SSMSG 

-MCALL .IOMG. 

~IOMG. SYM,<LO-128.>,<MSG> 
-ENDC 

-ENDM .QIOE. 


Conditional Data for Writing a Message File 


-MACRO .IOMG. SYM,LO,MSG 

~WORD -“O<LO> 
-ASCIZ2 “~MSG* 

. EVEN 

-IIF LT,“ O<SSSMAX+<LO>> ,SSSMAX=-“0O<LO> 
~-ENDM .IOMG. 


C.9.6 QIOSYS Macro 


This macro defines standard QUEUE I/O directive function values 
IOSB return values. To invoke at assembly time (with 


definition) use: 
QIOSYS ;Define symbols 
To obtain global definition of these symbols use: 


QIOSY$ DEFSG :Symbols defined globally 


This macro can be called once only. It then redefines itself 


null. 


-MACRO QIOSYS SSSGBL,SSSMSG 

-IIF IDN,<SSSGBL>,<DEFSG>, .GLOBL QI.VER 
~IF IDN,<SSSMSG>,<DEFSS> 

$$SMAX=0 

SSMSG=1 

.IFF 

SSMSG=0 

.ENDC 

.MCALL IOERRS 


IOERRS $S$SGBL 7I1/O error codes from handlers, FCP, 


FCS 
-MCALL DRERRS 
DRERRS SSSGBL sDirective status word error codes 
~IF DIF,<SS$MSG>,<DEFSS> 
»MCALL FILIO$ 
FILIOS $$$GBL ;Define general QIO function codes 
»-MCALL SPCIOS 


SPCIOS S$S$S$GBL ;Device dependent I/O function codes 


»MACRO QIOSYS ARG,ARG1,ARG2 ;Reclaim macro storage 
-ENDM QIOSYS 

~ENDC 

~ENDM QIOSyYS 
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C.9.7 SPCIOS Macro 


Defines the function 


devices. 


QIO 


-MACRO SPCIOS SSSGBL 
-MCALL .WORD.,DEFINS 

-IF IDN,<SSSGBL> ,<DEFSG> 
.. GBL=1 

.IFF 

. + -GBL=0 

-ENDC 
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codes that are specific to 


QIO Function Codes for Specific Device Dependent Functions 


»WORD. 
-WORD. 
»WORD. 
-WORD. 
»WORD. 
»WORD. 
~WORD. 
»WORD. 
»WORD. 
«WORD. 
«WORD. 


IO.WLV,100,001 
IO.WLS,010,001 
IO.WNS ,020,001 
IO.WAL,010,001 
IO.WMS ,020,001 
I0.CCO,9040,001 
IO.WBT,100,001 
IO.WLT,010,001 
IO.WLC,020,001 
IO.WPB,040,001 
IO.WDD,044,001 


-WORD. 
»WORD. 
-WORD. 
-WORD. 
-WORD. 
-WORD. 
«WORD. 
-WORD. 
«WORD. 
-WORD. 
-WORD. 
»WORD. 
-WORD. 


IO.RLV,100 ,002 
IO.RST,001,002 
IO.RAL,010,002 
IO.RNE,020,002 
IO.RNC ,040 ,002 
IO.RTM,200,002 
IO.RDB,200 ,002 
IO.RHD,010 ,002 
IO.RNS ,020,002 
IO.CRC,040,002 
IO.RPB,040,002 
IO.ATA,010 ,003 
I0.GTS ,000,005 


.WORD. 
.WORD. 
»WORD. 
. WORD. 
.WORD. 
. WORD. 
.WORD. 
.WORD. 
«WORD. 
.WORD. 
.WORD. 
»WORD. 


IO.R1C,000 ,005 
IO.INL,000,005 
IO.TRM,010,005 
IO.RWD,000,005 
TO.SPB,020 ,005 
IO.SPF,040,005 
IO0.STC,100,005 
IO.SEC,120,005 
IO.RWU,140,005 
IO0.SMO0,160 ,005 
IO.HNG ,000 ,006 
IO.RBC ,000 ,006 


-WORD. 
»WORD. 
»WORD. 
» WORD. 
»WORD. 
»WORD. 
-WORD. 
-WORD. 
»WORD, 
-WORD. 


IO.MOD ,000 ,006 
IO.HDX,010 ,006 
I0.FDX,020 ,006 
IO0.SYN ,040 ,006 
IO.EOF,000 ,006 
IO.RTC,000 ,007 
I0.SA0,000,010 
I0.SS0,000,011 
IO.RPR,000,011 
IO.MSO,000,012 


DECTAPE) Write logical reverse 
COMM.) Write preceded by syne train 
COMM.) Write, no sync train 
TTY) Write passing all characters 
TTY) Write suppressible message 
TTY) Write with cancel CONTROL-o 
TTY) Write with breakthrough 
DISK) Write last track on RKO06 
DISK) Write logical with write check 
(RX1l1 DISK) Write physical block 
; (RX11 DISK) Write physical with 

; deleted data 
(MAGTAPE,DECTAPE) Read reverse 
(TTY) Read with special terminator 
(TTY) Read passing all characters 
; (TTY) Read without echo 
(TTY) Read ~ no lower case convert 
(TTY) Read with time out 
(CARD READER) Read binary mode 
;(COMM.) Read, strip syne 
(COMM.) Read, do not strip syne 
(COMM.) Read, do not clear CRC 
(RX11 DISK) Read physical block 
(TTY) Attach with ASTs 
(TTY) Get terminal support 

; characteristics 
AFC,AD01,UDC) Read single channel 
COMM.) Initialization function 
COMM.) Termination function 
MAGTAPE,DECTAPE) Rewind 
MAGTAPE) Space "N" blocks 
MAGTAPE) Space "N" EOF marks 
MAGTAPE) Set characteristic 
MAGTAPE) Sense characteristic 
MAGTAPE,DECTAPE) Rewind and unload 
MAGTAPE) Mount & set characteristics 
TTY) Hangup dial-up line 
Read multichannels (buffer 

; defines channels) 
(COMM.) Setmode function family 
(COMM.) Set unit half duplex 
; (COMM.) Set unit full duplex 
7 (COMM.) Specify syne character 
; (MAGTAPE) Write EOF 
;Read channel - time based 
; (UDC) Single channel analog output 
; (UDC) Single shot, single point 
; (TTY) Read with prompt 
; (UDC) Single shot, multi-point 
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individual 


» WORD. 
»WORD. 
-WORD. 
» WORD. 
-WORD. 
~WORD. 
-WORD. 
»WORD. 
-WORD. 
-WORD. 
«WORD. 
-WORD. 
-WORD. 


»WORD. 
-WORD. 


-WORD. 
«WORD. 


»WORD. 
»WORD. 
»WORD. 


»WORD. 
-WORD. 
»WORD. 
-WORD. 
-WORD. 
»WORD. 
-WORD. 
» WORD. 


-WORD. 
-WORD. 
-WORD. 
»WORD. 
«WORD. 
»WORD. 
-WORD. 
-WORD. 
»WORD. 
»WORD. 
-WORD. 
-WORD. 


-WORD. 
-WORD. 
»WORD. 
-WORD. 


-WORD. 
»WORD. 


IO0.SLO,000,013 
IO.MLO,000,014 
IO.LED ,000 ,024 
IO0.SDO0,000 ,025 
IO0.SDI,000,026 
I0.SCS ,000 ,026 
IO.REL,000 ,027 
IO.MCS,000 ,027 
IO.ADS ,000 ,030 
IO.CCI ,000 ,030 
IO.MDI,000,031 
IO0.DCI ,000,031 
IO.XMT,000,031 


IO.XNA,010,031 
IO.HIS,000,032 


IO.RCI ,000 ,032 
IO0.RCV,000,032 


IO.MDO ,000 ,033 
I0.CTI,000,033 
IO.CON,000 ,033 


IO0.CPR,010,033 
IO.CAS ,020 ,033 
IO.CRJ ,040 ,033 
I0.CBO,110,033 
IO0.CTR,210 ,033 
IO.GNI,010,035 
IO.GLI ,020,035 
IO0.GLC,030,035 


IO.GRI ,040,035 
IO0.GRC,050,035 
IO.GRN ,060,035 
IO0.CSM,070,035 
IO.CIN,100,035 
IO0.SPW,110,035 
IO.CPW,120,035 
IO.NLB,130,035 
IO0.DLB,140,035 
IO0.STD,000 ,033 
IO.DTI ,000 ,034 
TO.DIS,000 ,034 


IO.MDA,000 ,034 
IO.RTI,000,035 
IO.CTL,000,035 
I0.STP,000,035 


IO.CNT,000 ,036 
IO0.ITI,000,036 


ICS/ICR QIO Functions 


»WORD. 
»WORD. 
»WORD. 
»WORD. 
«WORD. 


IO.CTY ,000 ,007 
IO0.DTY,000,015 
IO.LDI ,000 ,016 
IO0.UDI,010,023 
IO.LTI,000,017 


MACRO EXPANSIONS 


; (UDC) Latching, 


single point 


+ (UDC) Latching, multi-point 


3 (LPS11) 
; (LPS11) 
:; (LPS11) 


(UDC) Contact sense, 


3; (LPS11) 


Write LED display lights 
Write digital output register 
Read digital input register 
single point 
Write relay 


; (UDC) Contact sense, multi-point 


* (LPS11) 


Synchronous A/D sampling 


(UDC) Contact int - connect 


: (LPS11) 


Synchronous digital input 


+ (UDC) Contact int - disconnect 


(COMM. ) 


‘ 
; 
: with ACK 
t 


Transmit specified block 


»>(COMM.) Transmit without ACK 


; (LPS11) 


Synchronous histogram 


sampling 
; (UDC) Contact int - read 


7 (COMM. ) 


Receive data in buffer 


; specified 


3 (LPS11) 


Synchronous digital output 


; (UDC) Timer - connect 


; (COMM. ) 
(VT11) 


: (COMM. ) 
: (COMM. ) 
> (COMM. ) 
: (COMM. ) 
: (COMM. ) 
: (COMM. ) 
3 (COMM. ) 
: (COMM. ) 
; clear 

; (COMM. ) 
3; (COMM. ) 
; (COMM. ) 
: (COMM. ) 
: (COMM. ) 
: (COMM. ) 
+ (COMM. ) 
; (COMM. ) 
; (COMM. ) 
; (LPA11) 


; 
,; processor 
‘ 


Connect function 
- Connect task to display 


Connect no timeouts 

Connect with AST 

Connect reject 

Boot connect 

Transparent connect 

Get node information 

Get link information 

Get link information - 
counters 

Get remote node information 
Get remote node error counts 
Get remote node name 

Change solo mode 

Change connection inhibit 
Specify network password 
Check network password. 

NSP loopback 

DDCMP loopback 

Start data transfer 


3 (UDC) Timer -— disconnect 


+ (COMM. ) 
; (VT11) 


Disconnect function 
- Disconnect task from 


; display processor 


: (LPS11) 


Synchronous D/A output 


; (UDC) Timer - read 


+; (COMM. ) 
+ (LPS11) 
; (VT11) 
: (VT11) 


Network control function 
Stop in progress function 
- Stop display processor 
- Continue display processor 


+ (UDC) Timer - initialize 


;Connect to terminal interrupts 
;Disconnect from terminal interrupts 
;Link to digital interrupts 


:Unlink 


from digital interrupts 


;Link to counter module interrupts 
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»WORD. 


-WORD. 
° WORD s 


»WORD. 
«WORD. 
»WORD. 
» WORD. 
»WORD. 
«WORD. 


IP11 I/0 


»WORD. 
«WORD. 
»WORD. 
»~WORD. 
»WORD. 
»WORD. 
«WORD. 
- WORD. 
-WORD. 
» MACRO 


IO.UTI ,020 ,023 


TO,.LTY ,000 ,020 
IO .UTY ,030 ,023 


IO.LKE,000 ,024 
IO.UER,040 ,023 
IO.NLK ,000 ,023 
IO.ONL ,000 ,037 
IO.FLN,000 ,025 
IO.RAD,000 ,021 


Functions 


IO.MAO,010 ,007 
IO.LEI,010,017 
IO.RDD,010 ,020 
IO.RMT,020 ,020 
IO.LSI ,000,022 
IO.UEI,050 ,023 
I0.USI ,060 ,023 
IO.CSTI ,000 ,026 
IO.DST ,000 ,027 
SPCIOS A 


-ENDM SPCIOS 
-ENDM SPCIOS 


C.9.8 


Defines the I/0 
functions are implemented as a subfunction of I/O code 10 


',MACRO 
.MCALL 


UMDIO$ Macro 


codes 


UMDIOS S$SGBL 
»WORD. ,DEFINS 


for 


MACRO EXPANSIONS 


;Unlink from counter module 

; interrupts 

;Link to remote terminal interrupts 
;Unlink from remote terminal 
; interrupts 

;Link to error interrupts 
sUnlink from error interrupts 
;Unlink from all interrupts 
sUnit online 

;Unit offline 

;Read activating data 


;Multiple analog outputs 


;Link event flags to interrupt 


;Read digital data 
;Read mapping table 


;Link to DSI interrupts 


;Unlink event flags 

;Unlink from DSI interrupts 
;Connect to DSI interrupts 
;Disconnect from DSI interrupts 


user-mode diagnositcs. All 


-IF IDN <SSSGBL>,<DEFS$G> 


-- -GBL=1 
-IFF 
.- -GBL=0 
-ENDC 


General User-mode Qualifier Bit 


-WORD. 


IQ.UMD ,004,000 


;User mode diagnostic request 


User-mode Diagnostic Functions. 


»WORD. 
»WORD. 
»WORD. 
~WORD. 
»WORD. 
«WORD. 
»WORD. 
»WORD. 
»WORD. 


»WORD. 


IO.HMS ,000 ,010 
IO.BLS,010,010 
IO.OFF,020 ,010 
IO.RDH,030,010 
IO.WDH,040 ,010 
IO.WCK,050 ,010 
IO.RNF,060 ,010 
IO.RNR,070,010 
IO.LPC,100,010 


IO.ERS,110,010 


Home seek or recalibrate 
Block seek 

Offset position 

Read disk header 

Write disk header 

Writecheck (non-transfer) 
DECTAPE) Read block number forward 
DECTAPE) Read block number reverse 
MAGTAPE) Read longitudinal parity 
character 

(MAGTAPE) Erase tape 


Macro Redefinition to Null 


» MACRO 


UMDIOS A 


diagnostic 
(octal). 


~ENDM 
~ENDM UMDIOS 
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MACRO EXPANSIONS 


C.9.9 .WORD. Macro 


This macro defines the symbol SYM where LO is the low order byte and 
HI is the high byte. 


-MACRO .WORD. SYM,LO,HI 
DEFINS SYM,<°O<HI*400+L0O>> 
~-ENDM .WORD., 


C.10 SNAP CONTROL BLOCK AND SNAPSHOT DUMP MACROS 


The following macros are the macros for the snapshot dump debugging 
aid. 


C.10.1 SNAPS Macro 
SNAPS requests a snpashot dump. 


»-MACRO SNAPS CTL,EFN,ID,L1,H1,L2,H2,L3,H3,L4,H4,?LBLI, ?LBL2 
-MCALL SNPDFS ,WTSESS,SDATSS,RQOSTSS,CLEFSS 
SNPDFS 
e-ITF NB <CTL>, MOV CTL,..SPBK+SEB.CTL 
-IIF NB <EFN>, MOV EFN,..SPBK+SB.EFN 
-IIF NB <ID>, MOV ID,..SPBK+SB.ID 
-.-SNP = SB.LM1 
~-IRP X,<L1,H1,L2,H2,L3,H3,L4,H4> 
~L[F NB <X> 
MOV X,..SPBK+...SNP 
~ENDC 
-»-SNP = ...SNP+2 
»ENDM 
CLEFSS ..SPBK+SB.EFN iClear event flag 
BCS LBL2 
SDATSS #..SPBK+SB.PMD,#..SPBK ;Send snap information 
BCS LBL2 
RQSTSS #..SPBK+SB.PMD ;Request task "PMD..." 
BCC LBL1 
CMP #IE.ACT,@#SDSW ;0.K. if task already 
;active 
BEQ LBL1 
SEC 
BR LBL2 
LBL1: WTSESS ..SPBK+SB.EFN ;Wait for snapshot to 
;finish 
LBL2: 
~-ENDM SNAPS 


C.10.2 SNPBKS Macro 
SNPBKS$ generates a snap control block. 

-MACRO SNPBKS DEV,UNIT,CTL,EFN,ID,L1,H1,L2,H2,L3,H3,L4,H4 
SNPBKS never generates more than one block. 

IF DF ..SPBK 


eIIF NE <..SPBK-.>, .«MEXIT 
» ENDC 
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-MCALL SNPDFS 
SNPDFS$ 


The following code builds the control block. 


- -OPBK::.WORD CTL Control word 
-ASCII /DEV/ 7;Send out device name 
IF NE .-<..SPBK+SB.DEV+2> 
» ERROR ;Invalid device name "DEV" 
~MEXIT 
»ENDC 
»-BYTE UNIT,0O ;Device unit number & unused 
-WORD EFN ;Event flag number 
-WORD ID ;Snapshot identification word 
-WORD L1,H1 ;Dump address limits 
»~WORD L2,H2 
»~WORD L3,H3 
~WORD L4,H4 
»-RAD50 /PMD.../ ;Snapshot task name 


-ENDM SNPBKS 


C.10.3 SNPDFS Macro 
SNPDF$ generates snap offset and bit definitions. 


-MACRO SNPDFS GBL 

-IF IDN <GBL>,<DEFSG> 

-GLOBL SB.CTL,SB.DEV,SB.UNT,SB.EFN,SB.ID,SB.LM1,SB.PMD 
-GLOBL SC.HDR,SC.LUN,SC.OVL,SC.STK,SC.WRD,SC.BYT 

»ENDC 


C.11 STATE AND KEYWORD TABLE GENERATION MACROS 


These macros initialize table generation - they are called once at the 
Start of each finite state machine description. The user must supply 
labels for the state and keyword tables. 


C.11.1 ISTATS Macro 


»-MACRO ISTATS STTBL,KEYTBL 
-MCALL MTRANS 
-IF DF SRONLY 
»-PSECT S$SSTATE,D,RO 
LFF 
»-PSECT SSTATE,D 
~ENDC 

STTBL:: 
-IF DF SRONLY 
»-PSECT SKTAB,D,RO 
LFF 
-PSECT SKTAB,D 
»-ENDC 

KEYTBL?: 
-IF DF SRONLY 
-PSECT SKSTR,D,RO 


C-125 


MACRO EXPANSIONS 


~IFF 
»PSECT $KSTR,D 
.ENDC 

SSSKEY = -1 
SSSFLG = -1 
SEXIT = 0 
SLAMDA = 300 
SNUMBR = 302 
SSTRNG = 304 
SBLANK = 306 
SSUBXP = 310 
$SEOS = 312 
SDNUMB = 314 
SRAD50 = 316 
SANY = 320 
SALPHA = 322 
SDIGIT = 324 
»PSECT 


-ENDM ISTATS 


C.11.2 MTRANS Macro 
MTRANS sends out the last transition entry. 


-MACRO MTRANS 

-PSECT SSTATE 

~IF EQ S$SSFLG+1 

SSSFLG = 0 

.MEXIT 

~ENDC 

$$$TYP 

~-BYTE $SSFLG 

-IF NE SSSFLG&1l 

SSSEXT 

. ENDC 

~IF NE S$SFLG&2 

SSSACT 

~ENDC 

-IF NE S$S$SFLG&1O 

S$S$SBIT 

-ENDC 

-IF NE SSSFLG&4 

-WORD SSSSTA 

.IFF 

~IF EQ S$SSFLG&200 

»-ERROR "BAD DEFAULT TRANSITION" 
~ENDC 

.ENDC 

SSSFLG = 0 

-ENDM MTRANS 

.LIST 


C.11.3 STATES Macro 
STATES declares a state. 
»~MACRO STATES LABEL 

-PSECT SSTATE 


SSSFLG = $$$FLG!200 
MTRANS$ 
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.IF NB LABEL 
LABEL: .ENDC 

SSSFLG = -1l 

.PSECT 

.ENDM STATES 


C.11.4 TRANS Macro 
TRANS specifies a state transition. 


.MACRO TRANS TYPE,LABEL,ACTION,MASK,ADDR 
-PSECT SSTATE 
MTRANS 

.IF NB ACTION 
SSSFLG = S$SSFLG!2 
«MACRO $SSACT 
-WORD ACTION 
»-ENDM SSSACT 
»ENDC 

.IF NB MASK 
SSSFLG = S$S$S$FLG!30 
-IF B ADDR 

.ERROR "MASK ADDRESS NOT PRESENT" 
~ENDC 

«MACRO SS$SBIT 
-WORD MASK,ADDR 
-ENDM S$SSBIT 
~ENDC 

-IF NB LABEL 
SSSFLG = SSSFLG!4 
SSSSTA LABEL 
.ENDC 

~IRPC X,<TYPE> 
-IF IDN <X>,<"> 
»PSECT SKSTR 
SSSTMP = . 

-ASCII TYPE<377> 
-PSECT $KTAB 
-WORD SSSTMP 
-MACRO $$STYP 
~-BYTE S$SSKEY!200 
-ENDM SSSTYP 
SSSKEY = S$SSKEY+1 
-IF GT $SSKEY-63. 
»ERROR "TOO MANY KEYWORDS" 
.ENDC 

.MEXIT 

.ENDC 

.IF IDN <X>,<!> 
SSSFLG = S$SSFLG!1 
«MACRO SS$SEXT 
-WORD O'TYPE 
~-ENDM SSSEXT 
»MACRO S$SSTYP 
-BYTE SSUBXP 
-ENDM S$SSTYP 
.MEXIT 

»ENDC 

»-MACRO S$SSTYP 
-BYTE TYPE 

-ENDM SSSTYP 
.MEXIT 
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-ENDM 
-PSECT 
-ENDM TRANS 


C.12 SUBMIT FILE TO PRINT SPOOLER (PRT...) MACRO (PRINTS) 


C.12.1 PRINTS Macro 

The PRINTS macro takes the following form: 
PRINTS FDB,ERR 

where: 


FDB=Address of the FDB of the file to submit. 
ERR=Address of error routine. 


- MACRO PRINTS FDB,ERR,?LBL,A,B,C,D,E,F, ?LBL2 
-MCALL CALL,CLOSES$ ,LDRO$ ,GLUNSS 


LDROS FDB ;Load FDB address into R0 

TST F.BDB(RO) ;File open? 

BEQ LBL ;I£f eq no _ 

MOV R1,-(SP) Save Rl and R2 

MOV R2,-(SP) 

MOV R3,-(SP) ;Save R3 

MOV SP,R1 ;Save pointer to end of send buffer 
SUB #<8.*2>,SP s;Allocate a get LUN info buffer 
MOV SP,R2 sSave its address in R2 

MOVB F.LUN(RO),R3 :;Get LUN in R3 

GLUNSS R3,R2 7Get real device name and unit 
MOV G.LUCW(R2),R3 >Save characteristics word l 
MOV RO,R2 ;Copy FDB address 

ADD #F.FNB+N.DID+6 ,R2 *Point to end of directory ID 
MOV -(R2) ,-(R1) ;Push directory ID 


MOV ~-(R2) ,~(R1) 

MOV -(R2) ,-(R1) 

ADD #N.FID+6-N.DID,R2 :Point to end of file ID 

MOV -(R2) ,-(R1) :Push file ID 

MOV -(R2) ,-(R1) 

MOV -(R2) ,-(R1) 

CLRB ~-(R1) ;Clear LUN information flags byte 

ADD #N.FVER+2-N.FID,R2 ;Point to end of filename, type, 
; version 


MOV -(R2) ,-(SP) ;Push file version number 
MOV -(R2) ,-(SP) ;Push file type 
MOV -(R2) ,-(SP) ;Push filename 


MOV -(R2) ,-(SP) 
MOV -(R2) ,-(SP) 


MOV SP,R1 ;Set pointer to send buffer 
CLOSES RO ;Close file 
BCS LBL2 ;Skip on error 
BIT #FD.REC!FD.OSP,R3 ;Record oriented or spooled device? 
BNE LBL2 ;If ne yes 
MOV RO,R2 »>Save FDB address 
MOV #RPRT,RO Get "PRT" in RAD-50 
CALL SDSPAT ;Send data to ...PRT or PRT... 
MOV RO,F.ERR(R2) ;Get return status 
MOV R2,R0 ;Restore FDB address 
LBL2: ROR RL ;Save carry 
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ADD #<13.*2>,8P ;Clean stack 
ROL RL ;Restore carry 
MOV (SP)+,R3 ;Restore R3 
MOV (SP)+,R2 Restore Ri and R2 
MOV (SP)+,R1 
~IF NB ERR 
BCC LBL ;If CC okay 
CALL ERR :Call error routine 
» ENDC 
LBL: ;Reference label 


-ENDM PRINTS 


C.13 SET/GET SYMBOL (TTSYM$) MACRO EXPANSIONS 


C.13.1 TTSYMS Macro 


The TTSYMS macro file is used by RSX-11D, IAS, and RSX-11M terminal 
drivers. However, the RSX-11M terminal driver uses only a limited 
number of the symbols in this file. The TTSYMS macro defines all the 
symbols required for terminal SET and GET characteristics. 


.MACRO TTSYMS SSSGBL 


.MCALL DEFINS 
ee ~GBL=0 


-IF IDN,<SSSGBL>,<DEFSG> 


ee -GBL=1 
- ENDC 


DEFINS TC.WID,1. 
DEFINS TC.LPP,2. 
DEFINS TC.RSP,3. 
DEFINS TC.XSP,4. 
DEFINS TC.STB,5. 
DEFINS TC.ISL,6. 
DEFINS TC.RAT,7. 
DEFINS TC.TTP,8. 
DEFINS TC.SCR,9. 
DEFINS TC.SCP,10. 
DEFINS TC.HFL,11. 
DEFINS TC.VFL,12. 
DEFINS TC.NL ,13. 
DEFINS TC.SFF,14. 
DEFINS TC.HFF,15. 
DEFINS TC.LVF,16. 
DEFINS TC.HHT,17. 
DEFINS TC.NST,18. 
DEFINS TC.BSP,19. 
DEFINS TC.ACR,20. 
DEFINS TC.SMR,21. 
DEFINS TC.SMP,22. 


DEFINS TC.SMO,23. 
DEFINS TC.CCF,24. 
DEFINS TC.ALT,25. 
DEFINS TC.IMG,26. 
DEFINS TC.NKB,27. 
DEFINS TC.NPR,28. 
DEFINS TC.ESQ,29. 
DEFINS TC.LCP,30. 


;Line width 

;Lines per page 

;Receiver speed 

;Transmitter speed 

;Two stop bits 

;Subline on interface 

;Read-ahead type 

;Terminal type 

;Script line 

;Scope 

;Horizontal fill requirement 

;Vertical fill 

;ASCII newline terminal 

;Simulate formfeed and vertab 

; HARDWARE FORMFEED AND VERTAB 

;LA36 vertical fill 

s;Hardware horizontal tab 

;Non-standard hardware tab 

;Hardware backspace 

;Automatic carriage return required 

;Small character input enabled 

;Small character input required 
; (/lower case input) 

;Small character output enabled 

;CONTROL-C flushes type-ahead and read 

;Alternative ALTMODE recognition 

;IAS - messages inhibited 

;No keyboard 

;No printer 

;Escape sequence recognition 

;Local copy line 
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DEFINS TC.PAR,31. 


DEFINS TC.EPA,32. 
DEFINS TC.DLU,33. 
DEFINS TC.BLK,34. 
DEFINS TC.FRM,35. 
DEFINS TC.HLD,36. 
DEFINS TC.TAP,37. 
DEFINS TC.CEQ,38. 
DEFINS TC.NEC,39. 
DEFINS TC.SLV,40. 
DEFINS TC.PRI,41. 
DEFINS TC.UCO,42. 
DEFINS TC.UC1,43. 
DEFINS TC.UC2,44. 
DEFINS TC.UC3,45. 
DEFINS TC.UC4,46. 
DEFINS TC.UC5,47. 
DEFINS TC.UC6,48. 
DEFINS TC.UC7,49. 
DEFINS TC.UC8,50. 
DEFINS TC.UC9,51. 
DEFINS TC.MAX,52. 


MACRO EXPANSIONS 


Parity recognition/generation 
; required 

;Even parity 

;Dialup line 

:Block mode terminal 

;Forms mode terminal 

sTerminal hold mode 

;Low speed paper tape reader 

; compatible escape sequences 

; terminal in no-echo mode 

; terminal in slave mode 

; terminal is privileged 

;User characteristic 

s;User characteristic 

;User characteristic 

;User characteristic 

User characteristic 

;User characteristic 

;User characteristic 

;User characteristic 

;User characteristic 

;User characteristic 

;This must be one greater 

; than the highest value used 

+ for a symbol 


WDWAIHAU S WH FO 


Set Characteristic Error Codes 


DEFINS SE.ICN,1l. 
DEFINS SE.FIX,2. 


DEFINS SE.BIN,3. 


DEFINS SE.VAL,4. 


DEFINS SE.TER,5. 
DEFINS SE.SPD,6. 
DEFINS SE.SPL,7. 
DEFINS SE.PAR,8. 
DEFINS SE.LPR,9. 
DEFINS SE.NSC,10. 


DEFINS SE.UPN,11l. 


DEFINS SE.NIH,12. 


Subfunction Codes for the 


DEFINS SF.SSC, 
DEFINS SF.SMC, 
DEFINS SF.RDF, 
DEFINS SF.STT, 
DEFINS SF.STS, 
DEFINS SF.GSC, 
DEFINS SF.GMC, 
DEFINS SF.GAC, 
DEFINS SF.SAC, 
DEFINS SF.DEF, 


Speed Types 


DEFINS S.0 
DEFINS S.50 


res 
2 


24001020 
2400!040 
2400!060 
2400!100 
2400!120 
2400!140 
2400!160 
2400!200 
2400!220 
010 


;Wrong characteristic name 

;Attempt to change fixed 
characteristic 

Wrong value for binary 
characteristic 

Wrong value for non-binary 
characteristic 

;Wrong terminal type 

;Wrong speed for interface 

;Wrong split speed for interface 

;Wrong parity type for interface 

;Other wrong line parameters 

;Interface does not have settable 

; characteristics 

;No space to save default 

; characteristics 

; 

; 


me “6 4B NWO MO 


Characteristic not assembled in 
handler 


Set Characteristics Function 


;Set single characteristic 
;Set multiple characteristics 
;Restore default 

;Set terminal type 

;Set terminal type and speed 
;Get single characteristic 
;Get multiple characteristics 
;Get all characteristics 

;Set all characteristics 

;Set default characteristics 
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DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 


Terminal 


DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 


Bits for 


DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 


8.75 

S.100 
§.110 
8.134 
§.150 
$.200 
§.300 
$.600 
§.1200,11. 
$.1800,12. 
$.2000,13. 
§.2400,14. 
§.3600,15. 
$.4800,16. 
§.7200,17. 
S.9600,18. 
S.EXTA,19. 
S.EXTB,20. 


Types 


T.UNKO,0. 
T.AS33,1. 
T.KS33,2. 
T.AS35,3. 
T.L30S,4. 
T.L30P,5. 
T.LA36,6. 
T.VTO5,7. 
T.VT50,8. 
T.VT52,9. 
T.VT55,10. 
T.VT61,11. 
T.L180,12. 
T.SCRO,13. 
T.USRO,14. 
T.USR1,T.USRO+1 
T,USR2,T.USR1+1 
T.USR3,T.USR2+1 
T.USR4,T.USR3+1 


Return from 


F1.ACR,000001 
F1.BIW,000002 
F1.BUF,000004 
F1.UIA,000010 
F1.CCO,000020 
F1.ESQ,000040 
Fl .HLD,000100 
F1.LWC,000200 
F1.RNE,000400 
F1.RPR,001000 
F1.RST,002000 
F1.RUB,004000 
F1.SYN,010000 
F1.TRW,020000 
F1.UTB,040000 
F1.VBF,100000 
F2.SCH,000001 
F2.GCH,000002 
F2.DCH,000004 


‘GET 


MACRO EXPANSIONS 


Unknown (unspecified) 
;ASR33 

3KSR33 

sASR35 

*LA30S 

;LA30P 

+ LA36 

;VTO5 

;VT50 

2VT52 

3;VT55 

;VT6l 

;LA180S 
;Script line 
;User terminal 
;User terminal 
;User terminal 
;User terminal 
;User terminal 


& Oh kr O 


TERMINAL SUPPORT' 


;Auto CR/LF on long lines 
;Break through write 
;Intermediate buffering 
;Unsolicited input ASTs 
;Cancel CONTROL-O on write 
;Escape sequence support 

;Hold screen support 

; Lower case conversion 

;Read no echo 

;Read with prompt 

;Read with special terminators 
;Scope rubouts 

;XON/XOFF 

;Transparent read/write 
;Buffering in task buffer 
;EXEC buffers are variable length 
;Set characteristics 

;Get characteristics 
;Dump/restore characteristics 
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DEFINS F2.DKL,000010 
DEFINS F2.ALT,000020 
DEFINS F2.SFF,000040 


MACRO EXPANSIONS 


r;Historical 11D/IAS IO.KIL 
;ALTMODE is echoed 
:Formfeed can be simulated 


Subfunction Bits for Terminal Handler QIOs. 
Note: A complete list of terminal handler function and subfunction 


codes appears in this 


DEFINS 


DEFINS 
DEFINS 
DEFINS 
DEFINS 


DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 


«MACRO 
-ENDM 


TF.RST,001 


TF.BIN,002 
TF.RAL,010 
TF.RNE ,020 
TF.RNC,040 


TF.XOF,100 
TF.TMO,200 
TF .WAL,010 
TF.WMS ,020 
TF.CCO,040 
TF.WBT,100 
TF.SYN,200 
TF.AST,010 
TF.ESQ,020 


TTSYMS A 


-ENDM TTSYMS$ 
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appendix under QIOMAC, 


{IO.RLB/IO.RPR] Read with special 


[IO.WLB] 


[IO.ATT] 


terminators 
Send prompt as PASS ALL 
Read pass all 
Read with no echo 
Read with no case 
conversion 
Send XOF after prompt 
Read with timeout 
Write pass all 
Write suppressible message 
Cancel CONTROL-O 
Break through read 
Synchronous write 
Specify ASTs in attach 
Recognise escape sequences 
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APPENDIX D 


LISTING OF CONDITIONAL ASSEMBLY PARAMETERS 


D.1 LISTING OF CONDITIONAL ASSEMBLY PARAMETERS 


The following is a listing of all the conditional assembly parameters 
that are possible on the RSX-11M system. Many of these may not apply 
to your system but are listed here for your convenience. 


Parameter Definition 

ASSCHK ;Address checking 

ASS$CPS ;ACP support 

AS$DO01 ;AD01-D A/D convertors 

ASSF11 ;AFC11 A/D convertors 

ASSNSI ;ANSI magtape support 

ASSPRI ;ALTER PRIORITY directive 

AS$R11 ;AR11 laboratory peripheral systems 
ASSRDA ;AR11 D/A option 

ASSTRP ;AST support 

BSS$OOT ;Bootstrap ROM address 

CS$$CKP ;Checkpointing support 

CSSINT ;Connect interrupt vector support 
CS$LIsS ;Command language interpreter support 
CSSORE ;Size of dynamic storage region 
CS$SOVL ;Overlaid network ACP 

CS$R11 ;CR11 card readers 

CSSRSH ;Crash reporting 

CS$S$RUN ;Crash unit number 

DS$Bl1l ;DA11-B parallel line interfaces 
DSSBUG ;Panic dump routine 

DSSE11 ;DL11-E line interfaces 

DSSH11 ;DH11 asynchronous line multiplexers 
DSSIAG sUser mode diagnostics 

DSSISK ;Nonresident task Support 

D$$Jl1l ;DJ11 asynchronous line multiplexers 
D$$L11 7DL11/A/B/C/D line interfaces 

DSSM11 ;DM11BB modem control interfaces 
DS$P1l1 ;DP11 line interfaces 

D$$Qll ;DQ11 synchronous line interfaces 
DSSSHF ;Automatic dynamic memory compaction 
D$$ull ;DU11 line interfaces 

DS$wil ;DUP11 line interfaces 

DSSYNC ;Dynamic checkpoint allocation 
DSSYNM ;Dynamic memory allocation support 
D$$211 7;DZ11l asynchronous line multiplexers 
DS$$ ZMD ;DZ11 modem support 

ESSDVC ;Log device errors and timeout 
ESSEAE ;EAE support 

ESSNSI ;Log undefined interrupts 

ESSPER ;Log parity error traps 


Parameter 


ESSXPR 
FSSAST 
FSSLPP 
FSSLTP 
FSSLVL 
GS$S$TPP 
GS$S$TSS 
GSS$TTK 
GSSWRD 
Isscll 
IS$CAD 
ISSCDA 
ISscpDs 
ISSCIM 
ISS$CLK 
ISSCLT 
IS$CR 

ISSCRS 
I$scss 
ISscri 
ISSCWD 
I$$Gll 
ISSRAR 
ISSRDN 
I$$sll 
ISSSDR 
ISSSDS 
ISSSLK 
ISSSPW 
ISSSRC 
ISSsSsc 
KSSCNT 
KSSCSR 
KS$G11l 
KS$LDC 
KSSTPS 
KSSwll 
L$S11R 
LS$50H 
LSSASG 
LSSDRV 
LSSP11 
LS$SPsl 
LSSSBF 
LSSSDA 
LSSSDR 
LS$SGR 
LSS$SIl 
LDSAD 

LDSAF 

LDSAR 

LDSCR 

LDSCT 

LDSDB 

LDSDF 

LDSDK 

LDSDM 

LDSDP 

LDSDS 

LDSDT 

LDS$DX 

LDSLP 
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Definition 


;EXTEND PARTITION (task) directive 
;Asynchronous FPP 


-3Floating point processor support 


;FIS support 

;File structure level support 

:GET PARTITION PARAMETERS directive 
;GET SENSE SWITCHES directive 

;GET TASK PARAMETERS directive 

z;Include $GTWRD code 

;ICS/ICR-11 industrial control subsystems 
s;ICS/ICR-11 A/D convertor modules 
;ICS/ICR-11 D/A modules 

;ICS/ICR-11 digital sense input modules 
;ICS/ICR-11 digital interrupt modules 


;ICS/ICR-11 task activation from interrupts 


;ICS/ICR-11 bi-stable output modules 
;ICR-11 remote units 

;ICS/ICR-11 status recovery 
;ICS/ICR-11 single shot output modules 
s;ICS/ICR-11 I/O counter modules 
;ICS/ICR-11 error count 

7;KG11 CRC ootion 

;Install, request, and remove on exit 
71/0 rundown 

;DRS/DSS-11 input/output modules 
;DRS-11 output modules ‘i 3 
;DSS-11 input modules 

;Task activation from interrupts 
;DRS-1l status restore on power recovery 
;DRS-11 command register address 
7;DSS-11 command register address 
;Count register address 
7Programmable clock CSR address 
;KG11 CRC option 

;Load count value 

;Ticks per second 

;KW11-Y support 

;Fast printer support 

750HZ line frequency 

;Logical device assignment support 
;Loadable driver support 
;LP/LS/LV11/LA180 line printers 
;LPS11 laboratory peripheral systems 
;LPS1l1 bandwidth filtering 

;LPS11 D/A option 

;LPSDR-A present 

;LPS11 gain ranging option 

;LSI-1l1 processor 

;Loadable ADDRV 

;Loadable AIFDRV 

;Loadable ARDRV 

;Loadable CRDRV 

;Loadable CTDRV 

;Loadable DBDRV 

;Loadable DIFDRV 

;Loadable DKDRV 

;Loadable DMDRV 

;Loadable DPDRV 

;Loadable DSDRV 

;Loadable DTDRV 

;Loadable DXDRV 

;Loadable LPDRV 


Parameter 


LDSLS 

LDSMM 

LDSMT 

LDS PP 

LDSPR 

LDSTT 

LDSXB 

LDSXL 

LDS XM 

LDSXP 

LDSXQ 

LDS KU 

LDS XW 

MS SCRX 
MSSCRB 
MSSEXT 
MSSFCS 
MSSIXD 
MSSMGE 
MSSMUP 
MSSNET 
MSSOVR 
NSSCON 
NSSMOV 
NSSMXM 
NSSTMO 
PSSD70 
PSSGMX 
PSSLAS 
PSSP11l 
PSSP45 
PSSR11 
PSSRFL 
PSSRTY 
PSSSRF 
PSSTPT 
PSSWRD 
QSSCRC 
QSSHPT 
QSSOPT 
RS$115S 
RSS11M 
R$$611 
RSS6OF 
RSS6WC 
RSSDER 
RSSEXV 
R$$F11 
RSSJPO 
R$SJSs1 
RSSJP1 
RS$K11l 
R$ SKWC 
RSSLOD 
RSSNDC 
RSSLKL 
RSSNDH 
RSSNDL 
RS$P11 
RSSSND 
RS$Xll 
SSSECC 


LISTING OF CONDITIONAL ASSEMBLY PARAMETERS 


Definition 


;Loadable LSDRV 

;Loadable MMDRV 

;Loadable MTDRV 

;Loadable PPDRV 

;Loadable PRDRV 

;Loadable TTDRV 

;Loadable XBDRV 

;Loadable XLDRV 

;Loadable XMDRV 

;Loadable XPDRV 

;Loadable XQDRV 

;Loadable XUDRV 

;Loadable XWDRV 

;External MCR functions 

7;MCR command buffer length 

711/70 extended memory support 
;FCS/file system support 

;Mixed RH11 drive types 

;Memory management 

;Multi-user protection 

;Network ACP support 

;Overlayed MCR 

;Number of simultaneous logical channels 
;Size of BLXIO 'MOV' table 

;Maximum network data message size 
;Network control message timeout period 
711/70 cache parity support 

7Get mapping context 

;Program logical address extensions 
;PCll paper tape punch 

;Rotating data lights 

7;PR11 paper tape reader 

;Powerfail recovery 

;Parity memory 

;SEND/RECEIVE by REFERENCE 
;Point-to-point network support 
;Include $PTWRD code 

;DQ11 CRC option support 

7;DQ11 protocol option support 
;Pre-allocate I/O packets 

;RSX-11S system 

;RSX-11M system 

;RK611 disk cartridge controllers 
;RKO6 offset recovery support 
;RK611 write check support 

CORAL deallocation error checking 
;Extend Executive to 20k 

;RF11 fixed head disk controllers 
;Offset recovery support 
;RJ/RWS03-04 fixed head disk controllers 
;RJI/RWP04-05-06 disk pack controllers 
;RK11 cartridge disk controllers 
;RK11 write check support 

;Remote task loading 

;Clock ticks per scheduling interval 
;RMS-11 block locking 

;Highest priority class to consider 
;Lowest priority class 

;RP1L1-C/E disk pack controllers 
;SEND/RECEIVE directives 

;RX11 disk controllers 

;Shared Executive ECC code 


Parameter 


SSSWPC 
SSSWPR 
SSSWRG 
SSSYS2Z 
T$$18S 
TSS30P 
TSSA11 
TSSACR 
TSSBTW 
TSSBUF 
TSS$C11 
TSSCCA 
TSSCCO 
TSSCTR 
TSSESC 
TSSGMC 
TSSGTS 
TSSHLD 
TSSJ16 
TSSKMG 
TSSLWC 
TSSM11 
TSSMAN 
TSSMIN 
TSSRNE 
TSSRPR 
TSSRST 
TSSRUB 
TSSSMC 
TSSSYN 
TSSTRW 
TSSUTB 
TSSVBF 
TSSZAN 
USSACH 
USSADM 
USSAOM 
USSCIM 
USSCSM 
USSD11 
USSLTM 
USSMHI 
USSMLO 
USSMRN 
USSNIP 
USSSSM 
USSTIM 
VSSCTR 
V$$Ss25s 
Vsss60 
V$S$T1ll 
XSSDBT 
XSSM11 


LISTING OF CONDITIONAL ASSEMBLY PARAMETERS 


Definition 


;Clock ticks per swapping interval 
;Swapping priority 

;Console switch register present 
;Size of physical memory in 32W blocks 
;LA180S support 

;LA30P support 

;TAl11 dual cassettes 

:;Automatic CR/LF 

*Breakthrough write 

;Terminal input checkpointing 
;TC1l1l DECtape controllers 
;Unsolicited input AST 

;Write with control-0O cancellation 
s;Control-R support 

;Escape sequence support 

;Get terminal characteristics 

;Get terminal driver support 
;Hold-screen support A 
;TI/TWU16--45 magtape controllers 


;Task termination/device not ready messages 


;Settable case conversion (lower case) 
;TM/TMA/TMB11 magtape controllers 
;DM1L1BB answer baud rate 

;Baseline terminal driver 

;Read with no echo » 

;Read with prompt or after prompt 
;Read with special terminator 

7;CRT rubout 

;Set terminal characteristics 
;Terminal-host synchronization support 
;Transparent terminal read/write 
;User terminal input buffering 
;Variable length terminal input buffers 
;DZ11l answer baud rate 

Number of channels per module 

;ADU01 or IAD-IA module description 
;Analog output modules 

;Digital interrupt module description 
;Digital sense intput module 

;UDC1l1 Universal digital controller 
;Bi-stable output module description 
;High part of UNIBUS address 

;Low part of UNIBUS address 

;Address of next available UMR 
;Uni-polar A/D sampling 

;Single-shot output modules 

;I1/O counter module description 
;Address of highest vector plus 4 
;VS60 drives two CRT monitors 

;VS60 graphics display subsystem 
;VT11 graphics display subsystem 
;Executive debugging tool 

;DMC11 line interfaces 


APPENDIX E 


GENERAL FAULT ISOLATION 


E.1 INTRODUCTION 
This Appendix is a guide containing some general hints about fault 
isolation in the RSX-11M system. It is not an all-inclusive guide, 
but it does offer suggestions to get you started in the right 
direction. Other aids that may help you: 

@® RSX-11M Crash Dump Analyzer Manual 


® IAS/RSX-11]1 ODT Reference Manual (for the Online Debugging 
Tool) 


e® RSX-11M User Mode Diagnostics Reference Manual 


@ Executive Debug Tool (XDT) and Panic Dump, described in the 


RSX-11M Guide to Writing an I/O Driver 


@ RSX-11M Task Builder Reference Manual (for Post Mortem and 
Snapshot Dumps) 


E.2 FAULT CLASSIFICATIONS 
Four possible causes can be identified when the system faults: 


l. A user-state task has faulted such that it causes the system 
to fault (unmapped systems only) 


2. A user-written driver has faulted such that it causes the 
system to fault 


3. The RSX-11M system software itself has faulted 

4. The host hardware has faulted. 
You should immediately determine which of these four cases is’ the 
source of the fault. This section outlines the procedures that may 


help you to uncover the source of the fault. Correcting the fault is 
assumed to be your responsibility. 


E.3 SERVICING FAULTS 


Faults manifest themselves in roughly four ways. They are listed here 
in the order of increasing difficulty of isolation. 
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l. If XDT is included in your system, an unintended trap to XDT 
occurs. 


2. The system displays text indicating a crash has occurred and 
halts. 


3. The system halts but displays nothing. 


4, The system is in an unintended loop. 


Regardless of fault manifestation, you should immediately obtain 
pertinent fault isolation data. 


Case 1--The system has trapped to XDT 


The trap may or may not be intended (for example, you may not have 
removed a previously set breakpoint). If the trap is not intended, 
type the X command. This causes XDT to jump to location 40(8), from 
which the Executive stack and register dump routine (if present), 
followed by either Panic Dump or the Crash Dump Analyzer (CDA) support 
routine (if present), will be invoked. If, however, you have some 
idea of the source of the problem (for example, a recent coding 
change), then you can use XDT to examine pertinent data structures and 
code. 


Case 2 - The system has displayed text indicating a crash occurred 
If the text consists of output from the Executive stack and register 
dump routine, all the basic information describing the state of the 


system has been displayed. If the text has been produced by the CDA 
Support routine, follow the procedure for obtaining and formatting a 


memory dump as outlined in the RSX-11M Crash Dump Analyzer Reference 


Manual. 


Case 3--The system has halted but displays no information 


Before taking any action, examine and record the following 
information: 


@ Current PS and PC 

e General registers 

@e Executive stackpointer and stack 
e Executive PARS on a mapped system 
e Pertinent device registers 


The procedure depends on the particular PDP-11l processor. Consult the 
appropriate PDP-11 Processor Handbook for details. 


After preserving the PS and PC, invoke your resident debugging aid: 
enter 40(8) in the switch register, press LOAD ADDR, and then press 
START. The contents of 40(8) cause the successive invocation of: 

1. The Executive stack and register dump routine (if present) 


2, Either Panic Dump or CDA support routine (if present) 
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Case 4 - System is in an unintended loop 


Proceed as follows: 


l. Halt the processor 


2. Record PC and PS and any pertinent device registers, as in 
Case 3 above. 


You may then want to step through a number of instructions in an 
attempt to locate the loop. For this attempt to be meaningful you 
must first disable the system clock. Proceed as follows: 


1. Examine the contents of word 777546 (if your system has a 
line frequency clock) or word 772540 (if it has a 
programmable clock). 


2. Clear bit 6 in this word and redeposit the word. This 
disables the clock, 


3. The system will not run unless you reenable the clock. 


4. After trying to locate the loop and reenabling the clock, 
transfer to location 40(8) as in Case 3. 


E.3.1 Gathering Pertinent Fault Isolation Data 


Before proceeding with locating the fault, you should to dump the 
system common (SYSCM). SYSCM contains a number of critical pointers 
and listheads. Find the file SYSCM in the Executive memory allocation 
map listing, then enter the appropriate limits into the Panic Dump 
Routine. 


Alternately, you can run the Crash Dump Analyzer as a task; Oty. DE 
XDT is included in your system and a program condition causes a 
processor trap, control transfers automatically to XDT and typing X at 
your terminal causes control to be transfered to the crash dump 
routine. 
In addition, you should to dump the Dynamic Storage Region and the 
device tables. The Dynamic Storage Region starts in the module INITL 
and the device tables are in SYSTB. 
At this point, you have the following data: 

e PS 

e PC 

e The stack 


e RO through R6 
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e@e The Dynamic Storage Region 
e The Device Tables 
® System common 


These data are the minimum required to trace the fault effectively. 


E.3.2 Tracing Faults 


Three pointers in SYSCM are critical in fault tracing. These pointers 
are described below: 


SSTKDP - Stack Depth Indicator 
This data item indicates which stack was being used at the time 


of the crash. S$STKDP plays an important role in determining the 
origin of a fault. The following values apply. 


+1 -- User (task-state) stack 
0 -- System stack (system processing) 
-1 -- Interrupt processing only 


STKTCB - Pointer to the Current Task Control Block (TCB) 


The current TCB is the TCB of the user-level task in control of 


SHEADR - Pointer to the Current Task Header 


The SHEADR word points to the header of the task currently 
running. The task header provides additional data to help 
isolate the fault. Figures E-1l and E-2 show the layout of task 
headers for unmapped and mapped systems. 


The first word in the header is the user task's stack pointer 
(SP) the last time it was saved. If the user task branches 
wildly into the Executive, the Executive terminates the user 
task, but the system continues to function (possibly erroneously 
on an unmapped system). On a mapped system, only ae privileged 
task can enter and corrupt the Executive. Knowing the user 
task's stack pointer provides one more link in the chain that may 
lead to the resolution of the fault. 


The header (as pointed to by SHEADR) also contains the last-saved 
register set, just before the header quard word (the last word in 
the header, pointed to by H.GARD). 
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H.HDLN 


.Figure E-l Task Header on an Unmapped System 


Figure E-2 Task Header on a Mapped System 


E.3.2.1 Tracing Faults Using a Display of the Executive Stack and 
Registers - To trace a fault after a display of the Executive stack 
and register contents, first examine the system stack pointer. 
Usually an Executive failure is the result of an SST-type trap within 
the Executive. If an SST does occur within the Executive, the origin 
to the call on the crash reporting routine is in the SST service 
module. (The crash call is initiated by issuing an IOT at a_e stack 
depth of zero or less.) 
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A call to crash also occurs in the Directive Dispatcher when an EMT is 
issued at a stack depth of zero or less, or a trap instruction is 
executed at a depth of less than zero. The stack structure in the 
case of an internal SST fault is shown in Figure E-3. 


RETURN TO SYSTEM EXIT 


ZERO OR MORE SST PARAMETERS 


SST FAULT CODE 
NUMBER OF BYTES Sf SP 


Figure E-3 Stack Structure: Internal SST Fault 


The fault codes are: 


0 Odd address and traps to 4 

2 Memory protect violation 

4 Break point or trace trap 

6 IOT instruction 

10 Illegal or reserved instruction 
12 Non-RSX EMT instruction 

14 Trap instruction 

16 11/40 floating point exception 
20 SST abort - bad stack 

22 AST abort - bad stack 

24 Abort via directive 

26 Task load read failure 

30 Task checkpoint read failure 
32 Task exit with outstanding I/0 
34 Task memory parity error 


The PC points to the instruction following the one which caused _ the 
SST failure. The number of bytes is the number normally transferred 
to the user task's stack when the particular type of SST occurs. If 
the number is 4, an abnormal SST fault occurred, and only the PS and 
PC are transferred. There are no SST parameters. 


If the failure is detected in SDRDSP the stack is the same as that 
shown in Figure E-3, except the number of bytes, the SST fault code 
(the fault codes are listed above), and the SST parameters are not 
present. The crash report message, however, will indicate that the 
failure occurred in SDRDSP. 
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One SST-type failure, stack underflow, does not result in the stack 
Structure of Figure E-3. To determine where the crash occurred, first 
establish the stack structure; this can be deduced by the value of 
the SP and the contents of the top word on the stack. If the stack 
structure is that of Figure E-3, then the failure occurred in S$DRDSP, 
or waS anormal SST crash. If the stack structure is that of Figure 
E-4, then an abnormal SST crash has occurred. 


Figure E~4 Stack Structure: Abnormal SST Fault 


Abnormal SST failures occur when it is not possible to push 
information on the stack without forcing another SST fault. When this 
situation occurs, a direct jump to the crash reporting routine occurs 
rather than an IOT crash. The PS and PC on the stack are those of the 
actual crash, and the address printed out by the crash-reporting 
routine is the address of the fault rather than the address of the IOT 
that crashes the system. Note that the crash reporting routine 
removes the PC and PS of the IOT instruction from the stack, which in 
this case is incorrect. Thus, the SP appears to be 4 bytes greater 
than it really is (as in Figure E-4). 


You now have all the information needed to isolate the cause of the 
failure. 


E.3.2.2 Tracing Faults When the Processor Halts Without Display - To 
trace a fault when the processor halts but displays no information 
(Case 3 as described above), first examine SSTKDP, S$TKTCB, and SHEADR. 
Tracing failures in this case is difficult because the system stack is 
not directly associated with the cause of a failure. 


By examining SSTKDP, you can determine the system state at the time of 
the failure. If the system was in user state, examine the user task's 
stack. The examination focuses on scanning the stack for addresses 
that may be subroutine links that can ultimately lead to a thread of 
events isolating the fault. This is essentially the aim of looking at 
the system stack if S$STKDP is zero or less. 


Frequently, a fault can occur that causes the SP to point to the Top 
of Stack (TOS)+4. This fault results from issuing an RTI when the top 
two items on the stack are data instead of the return address (PC) and 
processor status (PS) for the routine being returned to. A wild 
branch occurs followed, most probably, by a halt. 


Figure E-5 shows a case in which two data items are on the stack when 
the program executes an RTI. TOS points to a word containing 40100. 
This word will be the new PC. Suppose that location 40100 contains a 
halt. After the RTI and the halt occurs, the SP points four bytes 
above the previous location, and fault tracing should begin from the 
previous SP. 
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sP 
~t————- AFTER RT! 


& 


—_———_ SP 
40100 ~t-————— BEFORE 
RTI 


Figure E-5 Stack Structure: Data Items on Stack 


This type of fault also occurs when an RTS instruction is executed 
with an inconsistent stack; that is, a stack with the wrong contents 
for the correct execution of the RTS instruction. The RTS instruction 
pops the top element off the stack. The top element of the stack 
becomes the new PC or occupies a register depending on the form of the 
RTS instruction. However, in any case, SP points to TOSt+2 after an 
RTS instruction. i 


A scan of the contents of the general registers may give some hint as 
to the neighborhood in which a fault (or the seguence of events 
leading up to the fault) occurred. 


If the fault occurred in a new driver, the buffer address and count 
words in the UCB (U.BUF, U.BUF+2, U.CNT), and the activity flags 
(US.BSY and S.STS) are frequent sources of clues. Other locations in 
both the UCB and SCB may also provide information that may help locate 
the source of the fault. 


E.3.2.3 Tracing Faults After an Unintended Loop - To trace a fault 
when an unintended loop has occurred, first halt the processor. After 
you halt the processor, the same state exists as in tracing faults 
when the processor halts without display (as described above). Follow 
the same tracing procedure described there. A specific suggestion is 
to check for a _ stack overflow loop. Patterns of data successively 
duplicated on the stack indicate a looping failure. 


E.3.2.4 Additional Hints for Tracing Faults - 


E.3.2.5 I/O Packets - Another item to check is the current (or last) 
I/O packet, the address of which is found in S.PKT of the SCB. The 
packet function (I.FCN) defines the last activity performed on the 
unit. 


If trouble occurred in terminating an I/O request, a scan of the free 
block list for the system Dynamic Storage Region may provide some 
insight. This list starts at the address contained in $CRAVL, a cell 
in SYSCM, Because all I/O packets are built in the system's Dynamic 
Storage Region, their memory is returned to the Dynamic Storage Region 
when they are successfully terminated. Following the link pointers in 
this region may reveal whether I/O completion proceeded to that point. 
In systems with QIO optimization, $PKAVL (SYSCM) points to a list of 
I/O packet-sized blocks of dynamic memory that are not linked into the 
SCRAVL chain. Normally, the last completed I/O packet is the first in 
the SPKAVL list. 
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A freguent error for an interrupt-driven device is to terminate an 1/0 
packet twice when the device is not properly disabled on 1/0 
completion and an unexpected interrupt occurs. This action ultimately 
produces a double deallocation of the same packet of dynamic memory. 
Double deallocation of a dynamic buffer in RSX-11M causes a loop in 
the routine $DEACB (in the CORAL module) on the next deallocation (of 
a block of higher address) after the second deallocation of the same 
block. At that time, R2 and R3 both contain the address of the I/0 
packet memory that has been doubly deallocated. If xXDT has’ been 
included in the system, the deallocation routine checks for bad 
deallocation and crashes the system if it occurs. Note, that queue 
I/O optimization, which employs pre-allocated I/O packets, may cause a 
double-deallocation error to get by. This may happen if the I/0 
packet in guestion does not become deallocated and is put ina 
separate list. To avoid this, use the SET /MAXPKT=0 command to 
temporarily void the optimization. 


E.3.2.6 System Stack Pointer - Use the system stack pointer to find 
the current position of the system stack. The system stack will 
contain addresses or instructions of code that was being executed 
prior to the crash (this is only true if the S$STKDP is less than 1). 
From this point, all call activity can be traced, with the help of the 
listings, back to the original S$SWSTK or EMT377 call. 
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SYSTEM TUNING 


This appendix is a brief synopsis of ways to improve the performance 
of an RSX-11M system. There may be many conflicting trade-offs and 
requirements in your particular installation; therefore, some 
techniques may not be applicable to your situation. This appendix is 
not intended to be the last word in system tuning, but is written in 
the nature of a general approach to system tuning and contains some of 
the techniques and concepts you can use to improve performance, 


F.1 HARDWARE CONSIDERATIONS 


The most obvious approach to improving system performance is to 
upgrade the hardware to faster and/or larger capacity devices. If 
your applications make heavy demands upon CPU time, it makes sense to 
upgrade to a faster processor. If your application involves many disk 
transfers, more CPU memory may be needed to reduce the number of 
transfers or fixed head disks may be needed to reduce transfer time. 
Heavily overlaid tasks require many disk transfers. If this 
constantly occurs, more memory may allow fewer task overlays. The use 
of memory management directives instead of overlaid tasks could 
improve system performance in this case. Also, consider the use of 
resident overlays or multiple copies of Fl1ACP, one for each volume, 
if you must use overlaid tasks with high I/O requirements. However, 
resident overlays require more memory. 


F.2 MEMORY LAYOUT 


The memory layout of your particular system is an important factor 
that affects system throughput. The following procedures improve 
throughput: 


e If your CPU has enough memory, put the following system 
programs in separate partitions to avoid their checkpointing 
each other: 

MCR, FI1ACP, TKTN, SHUFFLER 


@ Load loadable drivers into special driver partitions to avoid 
fragmenting memory. 


@e Arrange to have PLAS dynamic regions in their own special 
partitions. 
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F.3 EXECUTIVE SOFTWARE OPTIONS 


The options listed below are covered in detail in the RSX-11M System 
Generation Manual. The most important options that affect system 
performance include: 


Choice of FLIACP - If your memory is big enough, install 
BIGFCP as memory-resident to greatly improve disk access time. 
Install separate copies of F1l1ACP for each disk if file access 
is frequent and occurs to many different disks. .The /ACP 
switch in the Mount command selects the copy of FI11lACP for 
that particular disk. 


Dynamic checkpoint allocation on the fastest system disk on 
your system. 


Shuffling - The Shuffler, a nonresident privileged task for 
mapped systems compacts memory in a system-controlled 
partition. This task minimizes memory fragmentation and 
provides better memory usage. The Shuffler is a SYSGEN 
option. 


Round=-robin scheduling -—- Selection of the round-robin 
scheduling option during SYSGEN ensures that tasks in a range 
of priorities share the use of memory. This is important when 
many CPU-bound tasks within a specified range of priorities 
are running at the same time. 


Swapping - This SYSGEN option allows tasks to be checkpointed 
by tasks of equal priority when many tasks of equal priority 
are competing for memory. The checkpointing option is a 
pre-requisite. 


Memory management directives - Allows tasks to access a 
greater span of physical memory than their normal 32K 
addressing capability allows. 


Loadable device drivers - Loadable drivers may slow down I/O a 
bit, however, they occupy memory only when needed. 


Queue I/O speed optimizations - I/O throughput is increased at 
the expense of additional Executive code. Because of this 
option, I/O packets are pre-allocated, which makes’ them 
quickly available for QI0Os. 


Install, request, and remove on exit support - This option 
conserves Dynamic Storage Region space by allowing tasks to be 
memory resident only when active, but does not increase 
throughput. 


Checkpointing on terminal input - This SYSGEN option allows 
more copies of terminal I/O-bound tasks to be run than 
normally could be run in a given amount of memory. 


Error logging - This option can be useful when information 
about system errors (device errors, timeouts, cache and memory 
parity errors) is needed. However, file space is needed for 
the records and this option automatically includes support for 
checkpointing and the Send/Receive directives. 


Size of dynamic storage region - It is possible to exhaust 
dynamic memory during the running of RSX-11M. This can occur 
if a large number of tasks are installed, if many volumes” are 
mounted, or if a number of other conditions are present. This 
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problem can manifest itself in the lack of any response from 
the system. Although the system looks like it is operating 
successfully, it cannot accept any MCR commands or complete 
the execution of presently running tasks because they all 
require dynamic memory. Another manifestation of the problem 
may be I/0 errors being received by tasks or failures in the 
Loader due to pool allocation failures. The only solution to 
this problem is to bootstrap the system and make more dynamic 
space available (SET /POOL), remove tasks, mount fewer 
volumes, rebuild FCP with space for more file control blocks 
in its partition, or rebuild the system with more dynamic 
memory. See the RSX-11M System Generation Manual for a 
complete and detailed discussion of dynamic memory - its uses 
and its users. 


VMR installable Loader task - The Loader task occupies 2200(8) 
bytes and is one of the Executive tasks. Installing and 
fixing the Loader in its own partition releases the 2200(8) 
bytes for use in the Dynamic Storage Region. 


F.4 FILE SYSTEM OPTIONS 


Many Options of the INI and MOU commands can change performance. The 
more important options are: 


/EXT 


/INDX 


/ LRU 


/WIN 


default extension block count - Unless this block count is 
specified, the file has a default block count of five, whether 
it uses all five blocks or not. If the default is used and the 
file is larger than five blocks, the file is not continuous and 
more accesses are required for the file. If the file uses less 
than five blocks, all five blocks are reserved for the file and 
no other file can use them. On the other hand, if you specify 
one as the block count, the file gets only the number of blocks 
it needs but it may require many accesses to access the whole 
file. To conserve space and reduce the number of file 
accesses, be as specific as possible about the number of blocks 
that your files need. 


index file position - The position of the index file in large 
volumes is important because of seek time. Rather than have 
the index file at the beginning or end of a volume, position 
it, either by block number or the MID key word, at the 
mid-point of the volume. In the case of small volumes, such as 
a floppy-disk, putting the index file at the mid-point will 
limit the maximum size of the work files on the disk. In this 
case, put the index file at the beginning or end of the volume. 


memory buffers to speed up directory searches - LRU specifies 
the number of 51l2-byte buffers to be maintained in memory. The 
buffers contain only the most recently accessed directories. 
The default is three buffers. If your application is working 
with a small number of directories, the defaults may be 
sufficient. However, if many directories are being scanned 
frequently, access time will improve if you specify a higher 
number than three. However, more buffers use more memory. 


mapping pointer count - WIN specifies the number of mapping 
pointers to be allocated for file windows. The default is 
seven pointers. The pointers point to contiguous blocks of the 
file on the disk. Access to fragmented files may be optimized 
by increasing the number of pointers. However, additional 
memory may be freed by reducing the number of pointers for 
files with little or no fragmentation. 


F=3 
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HELPFUL HINTS 


Avoid entering CTRL/C to explicitly request MCR. Typing 
CNTRL/C slows down response to other users needing MCR 
facilities, 


Use indirect command files to MAC and TKB whenever possible, 
especially if the commands are long. If you do this, MAC or 
TKB spend less time competing for resources. 


When task building or assembling large programs, insert all 
modules in a created library and specify each module by name. 
This reduces the number of times that TKB or MAC have to open 
files. 


If you are doing SYSGEN with a mapped baseline system and your 
system has enough memory, create a separate 32K partition and 
install PIP, BIGTKB, and BIGMAC in this partition; this 
shortens the time taken for SYSGEN. 


If you have the room, install BIGTKB and BIGMAC with a large 
/INC. This reduces the system overhead that TKB and MAC would 
cause when they executed Extend Task directives. 


Install PIP with an increment (/INC). In general, run 
utilities in the largest possible partition. 


If your system uses RMS, build the library modules as 
memory-resident. 


Use the following form, shown as an example, to call utilities 
whenever you want to use a utility once: 


>PIP command <CR> 


Using this form reduces the time that PIP (or any other 
utility) spends competing for the memory resource. However, 
if you intend to use a utility to perform multiple operations, 
use: 


>PIP 

PIP> command <CR> 
PIP> command <CR> 
PIP> command <CR> 


CTRL/Z 

> 
Use the print spooler as much as_ possible. This avoids 
leaving utilities in memory while printing on the line 
printer. 


To save memory space by reducing task size, you may want to 
build a resident (sharable) library containing frequently-used 
FORTRAN routines. For the same reason, you May want’ to 
produce a position-independent library containing all the FCS 
modules required by a set of programs that are intended to run 
simultaneously. FCSRES.MAC and FORRES.MAC files are provided 
on the distribution disk. Building a FORTRAN and FCS resident 
library is described in the RSX-11M System Generation Manual. 


Plan the overlay structure of your tasks. You may possibly 
achieve a large reduction in disk accesses by careful 
planning. 
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@® Avoid putting all the files needed by an application in a 
Single UIC. Having all files in a single UIC slows down 
directory searches as each block can hold 32 entries only (8 
words per entry). Many more disk accesses are required to 
search for the 300th file in a single UIC than the 30th file 
in the last of 10 UICs. 


® RMDEMO does add some overhead to the system's operation. It, 
is not necessary to run RMDEMO continously, only when the 
information that it supplies is required. However, if you do 
not run RMDEMO continuously, you may not be able to observe 
the system when a problem occurs (for example, dangerously low 
and decreasing pool space). 


F.6 SOME OSEFOL COMMANDS 
There are four commands that can give you a description of your system 
that may be useful when you tune your system. They are the Tasklist, 
the Partition Definitions, the Task List, and the Active Task List 
commands. These commands are more fully described in the RSX-11M 
Operator's Procedures Manual. 
TASK LIST - Short Version 
The Tasklist command displays on the entering terminal a brief 
description of each installed task. The display contains, from left 
to right: 

1. Task name 
- Task version identification 


Partition name 


> us ie) 
a 


- Task priority 
5. Size of task in bytes (8) 
Load device identification 
7. Disk address logical block number (8) 
8. Task memory state 
Format: 
TAS 
Example: 
.»-LDR 07.05 LDRPAR 248. 00002200 LBO:-01035303 FIXED 
TKTN 03.3 SYSPAR 248. 00010000 LBO:-01126742 
RMDEMO X03.03 GEN 225. 00013700 SY0:-00352100 
MTAACP 0006 GEN 200. 00013000 DS0:-00000777 


FLIMSG V0O010 GEN 200. 00005400 SY¥0:-01053030 
«»-MCR O1 GEN 160. 00025000 LBO:-01051676 


ETC. 


PARTITION DEFINITIONS 
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The Partition Definitions command displays on the entering terminal a 
description of each memory partition in the system, 


The display consists of five columns that specify (in order from left 


to right): 


1. Partition name 


Partition 


2 
3. Partition size 
4 


.- Partition kind: 


5. Partition type 


(8) 


base address (8) 


Imain partition (MAIN) or subpartition (SUB) 


TASK for user-controlled 
COM for common 
DEV for device registers 
SYS for system-controlled 
Taskname for task region 


D 


..MIC for dynamically created region 


DRIVER for region occupied by a loadable driver 


Format: 


PAR 


Example: 


Name 
LDR 
SYSPAR 
FCPPAR 
PMDPAR 
SPLPAR 
DRVPAR 


GEN 


TASK LIST - Long Version 


Base Size 

000000 000000 
120000 010000 
130000 026000 
156000 020000 
156000 010000 
176000 014000 
176000 001600 
177600 000500 
200300 003000 
201300 001100 
202400 002000 
203400 003100 
212000 546000 
212000 013400 
225400 045700 

ETC. 


The Task List command displays 
and status of 
installed task in the system. 


descriptions, 


Type 
MAIN 
MAIN 
MAIN 
MAIN 
SUB 
MAIN 
SUB 
SUB 
SUB 
SUB 
SUB 
SUB 
MAIN 
SUB 
SUB 


on the 


TASK 
TASK 
TASK 
TASK 
TASK 

SYS 
DRIVER - 
DRIVER - 
DRIVER - 
DRIVER - 
DRIVER - 
DRIVER - 
SYS 
(RMDEMO) 
(...EDI) 


entering 


all installed 


DB: 
DS: 
DK: 
DT: 
LP: 
MM: 


terminal the names, 
tasks or of a specific 
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The display contains, reading from left to right, the following 
information for each task: 

® Task name 

@ Task control block physical address (8) 

@ Partition name 

@ Partition control block physical address (8) 

@e Partition base and limit physical address (8) 

e Task's running priority and default priority 

@e Task status flags 

e TI terminal physical device unit 

e I/0 count (10) 

° Task local event flags 

® Task registers and processor status word (memory-resident 

tasks only) 

Format: 


TAL [taskname] 


Example; 


LDR. 052220 LDR 052164 00000000-00000000 PRI - 248. DPRI —- 248. 
STATUS: -CHK FXD STP PRV 
TI - cOO: I0C - 0. EFLG - 000001 000000 PS - 170000 Pc - 041350 
REGS 0-6 000162 004030 177777 105312 064254 105260 052132 

TKTN 105010 SYSPAR 107734 00110000-00120000 PIR - 248. DPRI - 248. 
STATUS: -EXE OUT -CHK -PMD PRV 
TI - cOO: I0C - 0. EFLG - 000001 000000 


ETC. 


ACTIVE TASK LIST 

This command displays on the entering terminal the names, 
descriptions, and status of all active tasks in the system or the 
status of a specified active task (taskname). The display is the same 
as the Task List command. 


Format: 


ATL [taskname] 
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F.7 A USEFUL TOOL 


RMDEMO is a privileged task that displays in a highly visual and 
active manner information concerning task activity in an RSX-11M 
system. The display usually runs continuously on a video terminal 
with cursor control (the VTO5B or the VT52). Certain versions of the 
task allow a once-only display on any record-oriented device. 


The display features include: 
1. Current date and time; 
2. The currently active task; 


3. All tasks, loaded drivers, and common blocks that are 
currently in memory, displayed in a graphic fashion to show 
their individual memory requirements and location relative to 
other tasks; 


4, The number of active tasks currently in memory, the number 
not currently resident, and the total amount of memory 
occupied by eacn group; 


5. The current amount of available system dynamic memory (POOL 
space), including the largest available block and the number 
of fragments; . 


6. A graphical display of the partition information; 


7. The number of hours that have elapsed since RMDEMO was 
initiated (this is system up time if the STARTUP_CMD file 
automatically runs RMDEMO when your system comes up). 


8. The number of free blocks available on the system device and 
one or more additional mounted FILES-11 volumes; 


9. The system error sequence count. 


RMDEMO scales the display to the memory size of the computer on which 
it is executing. The amount of memory displayed on the screen is 
always the next largest power of 2 in K-words. For a 28K system, it 
displays 32K. For a 256K system, 256K is displayed and the available 
memory just fills the screen. 


You should consider task locations and sizes that RMDEMO displays to 
be approximate only. RMDEMO provides a visual display and is a system 
debugging tool; however, it should not be used for accurate 
measurement of task size and location. 


A complete description of RMDEMO can be found in the RSX-l11M_ System 
Generation Manual. 
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example of 3-15 
Interrupt routines, processing 
within 3-12 
Interrupt Transfer Block 8-40 
Interrupt vectors 1-16 
Interrupts, classes of 3-1 
device 3-2 
Executive processing 3-2 
external 1-17 
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MCR interface 1-25 
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MCR task 1-5 
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PPTAB 
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SYSTB 9-12 
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TTDRV 9-13 
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MRKTS macro C-39 
MRKTSC macro C-38 
MRKTSS macro C-39 
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Multiuser protection 1-27 
MVBS macro C-40 


N 


Naming B-2 
NBOFSL macro C-91 
NBOFFS macro C-92 
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C~100 
NMBLK$ macro C-92 
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system 1-3 
SNXTSK diagram 2-37 
SNXTSK routine 2-13 
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OPNSSW macro C-95 
OPNTSD macro C-95 
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PCB (see partition control block) 
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Index-10 


INDEX (Cont.) 


PLAS macro definitions C-101 
PLSUB module description 7-64 
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Pre-allocated I/O packet queue 
8-21 
Print spooler 1-7 
Print spooler, macro for 
submitting a file to C-128 
PRINTS macro C-128 
Priority 1-11 
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Region protection 2-9 RSX-11M supported devices a~1l 
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dynamic 2-8 RUNSC macro C-53 

Mapping to 1-15 RUNSS macro C-54 
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task 2-8 
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Register standards B-2 Save command 1-2 
Registers B-2 SAVNR macro C-74 
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REQSB module description 7-69 8-18 
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offsets 8-50 SCBLB macro C-74 

Resident tasks 1-10 Scheduling 1-2, 1-12 
Resource management, memory 1-2 SSCNDT routine 8-4 
Restart, power failure 1-29 SDATS macro C-57 
RETURN macro C-74 SDATSS macro C-56 
RFAS macro C-50 SDATSC macro C=-56 
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SYS 9-54 
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C-129 
SETD macro C-75 
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Snap control block macro C-124 
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SNPBKS macro C-124 
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SOB macro C~-75 
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processing routines 3-11 
STD (see system task directory) 
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STD macro C-75 
STFPS macro C-75 
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STST macro C-75 
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RSX-11M A-1 
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SVDBSC macro C-64 
SVTKS macro C-66 
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Swapping, disk 2-12 
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SWSTKS macro C-76 

SWSTKS$ routine, described for a 
mapped system 4-5 

described for an unmapped 

system 4-8 

SWSTKS, used by privileged tasks 
4-5 

Symbols B-2 
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Synchronous traps 1-18 
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SYSPAR 1-7 
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Mapped system E-5 
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8k nonprivileged user, in 
in mapped system 4-13 
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system 4-12 
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Task scheduling 1-2 
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accessing the I/O page 4-2 
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